X Marked-Up Version of Subsitute Specification 

^ Application 10/068,077 



>;^^^^j^PYRIGHT AUTHORIZATION 

A portion of the disclosxire of this patent document contains material which is 
subject to copyright protection. The copyright owner has no objection to the facsimile 
reproduction by anyone of the patent disclosure, as it appears in the PTO patent file or 
records, but otherwise reserves all copyright rights whatsoever. 
TITLE OF THE INVENTION 

[0001] Execution of Process by Reference to Directory Service 
REFERENCE TO COMPUTER PROGRAM LISTING APPENDIX 
[0002] The "computer program listing appendix. ^ beiny the rnm puter files listed below, 
as recorded on two identical copies (labeled Copy 1 and Copy 2) of a single compact disk 



roooal 


Name 


Size 


Tvue 


Date Created 


[0004] 


cl l.txt 


712 


Text Document 


12/28/2005 10:07 AM 


rooosi 


c2 O.txt 


2.933 


Text Document 


12/28/2005 10:07 AM 


roooel 


c2 l.txt 


1.330 


Text Document 


12/28/2005 10:07 AM 


fOOOTl 


c2 2.txt 


134 


Text Document 


12/28/2005 10:07 AM 


rooosi 


c2 3.txt 


126 


Text Document 


12/28/2005 10:07 AM 


rooo9i 


c2 4.txt 


92KB 


Text Document 


12/28/2005 10:07 AM 


roolo] 


c2 5.txt 


137 


Text Document 


12/28/2005 10:07 AM 


room 


c2 6.txt 


110 


Text Document 


12/28/2005 10:07 AM 


rooi2] 


c2 7.txt 


113 


Text Document 


12/28/2005 10:07 AM 


rooi3i 


c2 8.txt 


1.827 


Text Document 


12/28/2005 10:07 AM 


rooi4] 


c2 9.txt 


788 


Text Doctunent 


12/28/2005 10:07 AM 


rooisi 


c2 lO.txt 


276 


Text Document 


12/28/2005 10:07 AM 


rooiel 


c2 Il.txt 


718 


Text Document 


12/28/2005 10:07 AM 


[0017] 


c2 12.txt 


134 


Text Document 


12/28/2005 10:07 AM 


roois] 


c2 13.txt 


187 


Text Document 


12/28/2005 10:07 AM 


rooi9i 


c2 14.txt 


96 


Text Document 


12/28/2005 10:07 AM 


r0020] 


c2 15.txt 


186 


Text Document 


12/28/2005 10:07 AM 


[0021] 


c2 16.txt 


448 


Text Document 


12/28/2005 10:07 AM 


[0022] 


c2 17.txt 


704 


Text Dociunent 


12/28/2005 10:07 AM 
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[00231 


c2 18.txt 2.728 


Text Document 


12/28/2005 10:07 AM 


[00241 


c3 O.txt 


1.527 


Text Document 


12/28/2005 10:07 AM 


[00251 


c3 l.txt 


202 


Text Docvmient 


12/28/2005 10:07 AM 


[00261 


c3 2.txt 


1.582 


Text Document 


12/28/2005 10:07 AM 


[00271 


c3 3.txt 


216 


Text Docimient 


12/28/2005 10:07 AM 


[00281 


c3 4.txt 


200 


Text Dociunent 


12/28/2005 10:07 AM 


[00291 


c4 l.txt 


14KB 


Text Document 


12/28/2005 10:07 AM 


[00301 


c4 2.txt 


1.500 


Text Document 


12/28/2005 10:07 AM 


[00311 


c4 3.txt 


810 


Text Document 


12/28/2005 10:07 AM 


[00321 


c4 4.txt 


758 


Text Document 


12/28/2005 10:07 AM 


[00331 


c4 5.txt 


62KB 


Text Docimient 


12/28/2005 10:07 AM 


[00341 


c4 6.txt 


298 


Text Document 


12/28/2005 10:07 AM 


f0035] 


c4 7.txt 


241 


Text Document 


12/28/2005 10:07 AM 


[00361 


c5 O.txt 


613 


Text Document 


12/28/2005 10:07 AM 


[00371 


c6 O.txt 


680 


Text Document 


12/28/2005 10:07 AM 


[00381 


c7 O.txt 


437 


Text Dociament 


12/28/2005 10:07 AM 


[00391 


c8 O.txt 


4.574 


Text Document 


12/28/2005 10:07 AM 


[00401 


c9 l.txt 


5.153 


Text Document 


12/28/2005 10:07 AM 


[0041] 


c9 2.txt 


1.535 


Text Document 


12/28/2005 10:07 AM 


[00421 


c9 3.t3ct 


1.628 


Text Document 


12/28/2005 10:07 AM 


[00431 


c9 4.txt 


6.330 


Text Document 


12/28/2005 10:07 AM 


[00441 


c9 5.t3ct 


1.562 


Text Document 


12/28/2005 10:07 AM 


[0045] 


clO l.txt 


1.482 


Text Document 


12/28/2005 10:07 AM 


[0046] 


clO 2.t3d; 


1.043 


Text Document 


12/28/2005 10:07 AM 


[0047] 


clO 3.txt 3.112 


Text Dociunent 


12/28/2005 10:07 AM 


[00481 


clO 4.txt 


841 


Text Document 


12/28/2005 10:07 AM 


[00491 


clO 5.txt 


1.277 


Text Document 


12/28/2005 10:07 AM 


[0050] 


cll l.txt 


239 


Text Docvunent 


12/28/2005 10:07 AM 


roosn 


cl2 l.txt 


510 


Text Docvunent 


12/28/2005 10:07 AM 


[00521 


cl2 2.txt 


288 


Text Document 


12/28/2005 10:07 AM 


[0053] 


cl2 3.txt 


350 


Text Docvunent 


12/28/2005 10:07 AM 
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[0054] 


cl2 4.txt 


1.658 


Text Document 


12/28/2005 10:07 AM 


[00551 


cl2 5.txt 


1.845 


Text Document 


12/28/2005 10:07 AM 


[00561 


cl3 l.txt 


4.161 


Text Document 


12/28/2005 10:07 AM 


[00571 


cl3 2.txt 2.860 


Text Docviment 


12/28/2005 10:07 AM 


[00581 


cl3 3.txt 


733 


Text Document 


12/28/2005 10:07 AM 


[00591 


cl3 4.t3d; 4.074 


Text Document 


12/28/2005 10:07 AM 


[00601 


ci4 o.txt saa 


Text Document 


12/28/2005 10:07 AM 


[00611 


cl4 l.txt 


1.087 


Text Document 


12/28/2005 10:07 AM 


[00621 


cl4 2.txt 


1.555 


Text Document 


12/28/2005 10:07 AM 


[00631 


cl4 3.txt 


376 


Text Document 


12/28/2005 10:07 AM 


[00641 


cl4 4.trt 409 


Text Document 


12/28/2005 10:07 AM 


[00651 


cl5 O.txt 257 


Text Document 


12/28/2005 10:07 AM 


[00661 


cl5 l.txt 


1.291 


Text Document 


12/28/2005 10:07 AM 


[00671 


cl5 2.txt 


1.272 


Text Document 


12/28/2005 10:07 AM 


[00681 


cl5 3.txt 


3.374 


Text Document 


12/28/2005 10:07 AM 


[00691 


cl6 l.txt 


5.489 


Text Document 


12/28/2005 10:07 AM 


[00701 


cl6 2.txt 


350 


Text Document 


12/28/2005 10:07 AM 


[00711 


cl6 3.txt 


379 


Text Document 


12/28/2005 10:07 AM 


[00721 


cl6 4.txt 


124 


Text Document 


12/28/2005 10:07 AM 


[00731 


cl6 5.txt 


753 


Text Document 


12/28/2005 10:07 AM 


[00741 


cl6 6.txt 


472 


Text Document 


12/28/2005 10:07 AM 


[00751 


cl6 7.txt 


1.275 


Text Document 


12/28/2005 10:07 AM 


[00761 


cl6 8.txt 


180 


Text Docxmient 


12/28/2005 10:07 AM 


[00771 


cl6 9.txt 


885 


Text Document 


12/28/2005 10:07 AM 


[00781 


cl6 lO.txt 388 


Text Document 


12/28/2005 10:07 AM 


[00791 


cl6 ii.txtsia 


Text Document 


12/28/2005 10:07 AM 


[00801 


cl6 12.txt 366 


Text Document 


12/28/2005 10:07 AM 



BACKGROUND OF THE INVENTION 
feQQ3l[008ll Field of the Invention 
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■[0QO3^[0082] T his invention relates to a network and provides a means for a user to 
provide a service, to consume a service, and to access and interact with a 
multiplicity of services. 

feQftti[0083] Description of Related Art 

feQQ6^[0084] The Internet and the World Wide Web have grown in size and 
complexity since inception. A common activity is to use a graphic rendering 
program such as Microsoft Internet Explorer, Netscape Navigator, Opera, or even 
Microsoft Word, to request and graphically render a Hypertext Markup Language 
(HTML) document. In requesting the HTML document, the user indicates a 
Uniform Resource Identifier (URI) to the graphic rendering process. 

feQQ6i[0085] T he following terms are defined in: "Hypertext Transfer Protocol " 
HTTP/1.1, RFC 2616 Fielding, et al." One who is not skilled in the state of the art is 
encouraged to read the reference for clarity on the subject manner. 

feQQ?l[0086] URI - Uniform Resource Identifier. The generic set of all 
names/addresses that are short strings that refer to resources. 
feQQ^[0087] U RL ■ Uniform Resource Locator. An informal term (no longer used in 
technical specifications) associated with popular URI schemes- http, ftp, mailto, etc, 

feQQ9?[0088] URN - Uniform Resource Name. A URN is an URI that has an 
institutional commitment to persistence, availability, etc. Note that this sort of URI 
may also be a URL. See, for example, PURLs. A particular scheme, urn', specified 
by RFC2141 and related documents, intended to serve as persistent, location- 
independent, resource identifiers. 

feM^[0089] T he "http" scheme is used to locate network resoiurces via the HTTP 
protocol. This section defines the scheme-specific syntax 
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feOlri[0090] and semantics for http URLs. 

feQ3^[009l] http URL = "http:" "//" host [ ":" port ] [ abs jath I "?" query ]] 

teQ3^[0092] If the port is empty or not given, port 80 is assumed. The semantics 
are that the identified resource is located at the server listening for TCP 
connections on that port of that host, and the Request-URI for the resource is 
abs_path (section 5.1.2). The use of IP addresses in URLs SHOULD be avoided 
whenever possible (see RFC 1900 [24]). If the abs_path is not present in the URL, it 
MUST be given as "/" when used as a Request-URI for a resource (section 5.1-2). If 
a proxy receives a host name which is not a fully qualified domain name, it MAY 
add its domain to the host name it received. If a proxy receives a fully qualified 
domain name, the proxy MUST NOT change the host name. 

feO14i[0093] By way of example, but not limitation, the user can enter an http 
schema URL such as- 

feftl6i[0094] http V/w WW . gtlinc.com/products.html 

■feOl€l[0095] In this example, the user is requesting the products.html document 
fi-om the server given as www.gtHnc.com. 

feQl?4[0096] To retrieve the HTML document, the server must be running a 
Hypertext Transfer Protocol daemon (HTTPD) such as Apache from 
httpV/www.apache.org, or equivalent thereof. The HTTPD executes on a service 
provider system and listens for request on a port, typically port 80, which is a well- 
known, industry standard port, for the HTTP daemon. By using a standard port, a 
person can indicate to the Netscape Navigator, or equivalent thereof, to request an 
http document via a given Uniform Resource Location (URL). By having the 
standard port 80 used, anybody can request the URL since they do not have to 
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fe03^[0097] w orry about what port the HTTP Daemon is listening on. Otherwise, 
the user would have to indicate the desired port, such as httpV/www.gtlinc.com'399, 
where '399 indicates to connect on port 399. Using the industry standard port 
simplifies the data entry and the ability to access Hypertext Markup Language 
(HTML) documents. 

•t0O18}[0098] A user of a computer system (or somebody on behalf of the user) pays 
for access to the Internet through an Internet Service Provider (ISP), such as AT&T 
WorldNet, America On-Line, or Microsoft Network. In a typical situation, the ISP 
frequently blocks request to port 80 on the user computer system to prevent the 
user from running a web site via an HTTP Daemon on their home computer, on the 
well known port 80. The user could provide the HTTP Daemon on a different port, 
such as port 399, but nobody would know to access that port unless the user 
pubhshed the port number. Even in publishing the port number, the enormous 
potential audience would unlikely see the advertisement. 

feO19l[0099] A nother challenge for the user accessing the Internet through an ISP, 
is that the ISP frequently uses Dynamic Addressing. In such circumstances, an 
Internet Address is assigned only when the user connects to the Internet through 
the ISP. When the user disconnects, then the IP address will be reassigned to a 
different user. This poses a problem in publishing the alternative HTTP Daemon 
running on port 399 since the Internet Address changes each time the user access 
the Internet. Even cable modem providers frequently use dynamic internet 
addressing. In some cases though, a cable modem ISP may offer a dedicated 
Internet Address, but stiU frequently blocks port 80 on the user computer. In some 
cases, the ISP requires the user of the ISP service to enter an agreement wherein 
the user is precluded from running a service on port 80. Even if the user were to 
publish the current dynamic Internet address, they could only do so via publishing 
the physical address such as 190.190.83.2 and potentially the corresponding port. 
In any case, the user does not have a domain name associated with their computer 
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such as gtlinc.com, wherein they could publish the domain name, which is easier for 
a prospect visitor to remember. 

toOa^toOlOQ] A lthough the problem of port blocking and dynamic Internet 
Address assignment frequently affects a user of an ISP service, similar challenges 
are faced by the industry in general. By way of example, but not limitation, a 
computer provider, a software provider, a tax service provider, a news service, a 
stock broker, a sales person selling goods or services, and others offering goods or 
services, are limited to providing the HTTP Daemon on port 80 because it is the 
industry standard port for the HTTP daemon. If any of the aforementioned wished 
to provide an alternative service on a port other than port 80, they would have to 
undertake a massive marketing campaign to educate potential visitors (users or 
businesses requesting information) on the particular port number. 

feOatitoOlOl] T he industry currently has products and services for providing 
directory services, but the directory service is generally limited to the enterprise 
within which the directory service is executing. By way of example, the Sun 
Microsystems iPlanet Directory Service is sold as a light weight directory access 
protocol for administering directory services within the enterprise. Even at that, 
Sun marketing information indicates the iPlanet Directory Service as primarily for 
user administration within the enterprise. It does not provide a solution or function 
effectively for the global network. It does not provide a solution or function 
effectively for the Internet. 

feQ3ai[00102] Industry members such as IBM, Microsoft, Hewlett Packard, 
SAP, and even Sun Microsystems have been indicating the Universal Definition 
Discovery Interchange (UDDI) as a means for providing information on service 
providers. The UDDI Specification, (available on-line at httpV/www.uddi.org) 
however, does not indicate registration of information such as other than port 80. 
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feO83l[00103] A more generalized solution for accessing and interacting with 
services provided on the Internet is needed. 

■feQ34^[00104] It is therefore an object of this invention to provide methods and 

systems for accessing and interacting with a multiplicity of services. 

feOa6}[00105] The use of a service often wiU require payment for the services 
rendered. The standard method of providing credit card payment over the Web is 
viewed as insecure and tedious. A user completes a form displayed through the 
graphic rendering process and uses a pointing device such as a mouse to "click" on a 
graphical representation indicating to send the content of the user provided 
information to the service provider. 

feQ36i[00106] T he Microsoft Corporation recently announced their Passport 
implementation wherein a user subscribes to the Microsoft Passport service, 
provides credit card information such as card type, card number, expiration date, 
card holder, billing address, and possible other information such as shipping 
address. The disadvantage of the Microsoft Passport implementation is that 
Microsoft controls that information. By way of example, the subscriber payment 
information is maintained on a computer system administered by Microsoft. The 
data set that Microsoft maintains may be propagated to other servers as needed. 
While Microsoft claims the method to be secure, the disadvantage is that by having 
a centralized data set containing payment information for an enormous number of 
subscribers, would make that centralized data set a computer cracker*s main target. 

feoa?^[00107] A n alternative implementation is being proposed by Sun 
Microsystems under their Liberty AUiance consortium. Numerous members such as 
Mastercard, VISA, American Express, and others have signed up for the Liberty 
Alliance. The downside of the Liberty Alliance implementation is that as of today, 
the implementation is not yet defined. Furthermore, the indications are that they 
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will still transmit credit card payment information to port 80 of the service provider 
providing the service (i.e., sale of service or goods is still a service). Sun 
Microsystems currently offers the Java Wallet, which is a family of products written 
in the Java programming language that are designed to enable secure commerce 
operations. 

feOa^foOlOSl A n alternative payment mechanism is provided by PayPal, 
which is used quite frequently for auction sites such as www.ebay.com. The PayPal 
implementation, however, requires PayPal to act in the capacity of a credit card 
merchant. Therefore a buyer provides PayPal with credit card information and 
PayPal charges the credit card and receives payment. PayPal then credits the 
seller's account with the appropriate amount. A second disadvantage is that PayPal 
charges a transaction fee which is then deducted from the seller's amount. A third 
disadvantage is that both the buyer and the seller must provide account 
information, which is then maintained by PayPal. 

feQa^[00109l It is understood that a user of a computer system could cause a 
process to execute wherein the process can provide payment information to a 
requesting process. The disadvantage is that there is no mechanism for verifying 
whom the requesting process is executing on behalf of. In this case, the user 
process could provide payment information to anybody, including a computer 
hacker, and thus is unacceptable. 

teQ3^[00110] It is therefore another object of this invention to provide 
methods and systems for payment of services. 

feOStitoOllll In the current state of the computing industry, a user who 
desires to access a web page, but, who does not know the corresponding URI, must 
use a browser such as Microsoft Internet Explorer to visit a search engine such as 
Yahoo or Google and submit keywords to query for pages satisfying their request. 



Page 9 of 229 



Marked-Up Version of Subsitute Specification 
Application 10/068,077 



The user is then presented with one or more URIs and text descriptions of the 
content at the URL The user can then "click" on one of the URIs satisfying the 
request. The corresponding HTML document is then retrieved and rendered for the 
user to see. A disadvantage is that the user must undergo a two-step approach. 
First, the user must visit Google, enter the terms, and then "click" on the desired 
URL 

feQ3^[00112] It is therefore another object of this invention to provide 
methods and systems for simplifying connections. 

feOa^toOllSl A n alternative is provided by RealNames. RealNames allows a 
corporation, such as Global Technologies Ltd., Inc., to register a keyword GTL so 
that when a user enters GTL as the desired site, the RealName would be translated 
to httpV/www.gtHnc.com. The challenge, of course, is that the user must know the 
keyword. 

SUMMARY OF THE INVENTION 

feO3^[00114l A ccording to the present invention, a method for using a service 
in a computer network a first software component executes on a first computer. The 
first software component registers as a service with a directory service process 
executing on a second computer, and the directory service process creates a 
registration for the first component of software. A second component of software 
executes on a third computer and communicates to the directory service process, a 
request to access and interact with the first software component. The directory 
service process responds by locating the registration entry for the first component of 
software, and facilitates communication with the first component of software on 
behalf of the second component of software. 

BRIEF DESCRIPTION OF THE DRAWINGS AND LISTINGS 
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•[0Q36^[00115] Figure 1 is a diagram of a computer network communicating 

according to the present invention. 

feQ36i[00116] Figures 2-7 are flow charts of the operation of the present 
invention. 

feQS?4[00117] Figure 2 is a flowchart of a directory service connection service. 

feQ38l[00118] Figure 3 is a flowchart of a directory service use. 

feQ39i[00119] Figure 4 is a flowchart of a service provider registration. 

teQ4Qi[00120] Figure 5 is a flowchart of a service registration. 

■t00434[0012l] Figure 6 is a flowchart of a consumer registration. 

feQ43i[00122] Figure 7 is a flowchart of a consumer request for service. 

feQ43i[00123] Figures 8-13 are diagrams showing the communications 

relationships of different types of data providers in accordance with the present 
invention. 

fOQ44i[00124] Figure 8 is a schematic block diagram of connectivity depicting 

horizontal partition by category. 

fe046^[00125] Figure 9 is a schematic block diagram of connectivity depicting 

horizontal partition by provider. 

feQ46i[00126] Figure 10 is a schematic block diagram of connectivity depicting 

horizontal partition by activity. 
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{604?j[OQ127] Figure 11 is a schematic block diagram of connectivity depicting 

horizontal partition by cost. 

feQ48i[00128] Figure 12 is a schematic block diagram of connectivity depicting 
horizontal partition by protocol. 

feQ4rt[00129] Figure 13 is a schematic block diagram of connectivity depicting 
horizontal partition by entity type. 

feQ6Q}[00130] Figures 14-16 are diagrams depicting data transfer provided by 
a directory service. 

feOSrifoOlSl] Figure 14 is a diagram depicting a sample TDS with three 
service directories according to the present invention. 

■[0Q6a^[00132] Figure 15 is a diagram depicting a sample environment with five 

systems sharing TDS information according to the present invention. 

feQS^[00133] Figure 16 is a diagram depicting a sample TDS configuration as 
applied to directories provided through the Sun Solaris 2.7 operating system 
according to the present invention. 

feQ64}[00134] ^The program listings are as follows- 

feQ66i[00135] P rogram Listing 1.1 source code listing of one implementation 
for the replacement recv function 

feQ66i[00136] Program Listing 2.0 Engine Service engine.c 
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feO&fl[00137] P rogram Listing 2.1 Engine Service getnvpair.c 

fe06^[00138] P rogram Listing 2.2 Engine Service authorize.c- placeholder 
authorization service 

feQ68^[00139] P rogram Listing 2.3 Engine Service input.c- placeholder input 
service 

feQ6Q^[00140] Program Listing 2.4 Engine Service postprocess.c^ placeholder 

postprocess service 

feQG34[0014l] Program Listing 2.5 Engine Service preprocess.c- placeholder 

preprocess service 

feQ63^[00142] ^Program Listing 2.6 Engine Service process.c* placeholder 

process service 

■feQ63i[00143] ^Program Listing 2.7 Engine Service response.c- placeholder 

response service 

fe0&ti[00144] Program Listing 2.8 Engine Service readline.c: 
feQ66}[00145] P rogram Listing 2.9 Engine Service wait_read.c 
feQ6^[00146] Program Listing 2.10 Engine Service - peek.c 
feQe7i[00147] P rogram Listing 2.11 Engine Service peek^c.c 
feQ68^[00148] P rogram Listing 2.12 Engine Service main.c 



Page 13 of 229 



Marked-Up Version of Subsitute Specification 
Application 10/068,077 



feQ6Qi[00149] Program Listing 2.13 Engine Service - Makefile 
lQQ?Qi[00150] Program Listing 2.14 Engine Service ■ engine.mk 
fQQ?ri[0015l] Program Listing 2.15 Engine Service ■ dummy. mk 

feQ?al[00152] Program Listing 2.16 Engine Service - engine.conf 

feQ?3i[00153] Program Listing 3.0 authentication service • authenticate.c 

•feQ?^[00154] Program Listing 3.1 Authentication Service - log.h 

feft?6i[00155] Program Listing 3.2 Authentication Service - tds2.h 

feQ?6l[00156] Program Listing 3.3 Authentication Service - makefile 

feQy?4[00157] Program Listing 3.4 authentication Service • authenticate.conf 

feQ?gl[00158] Program Listing 4.1 ■ Thread Directory Service ■ tds3.c 
fe0?rt[00159] Program Listing 4.2 - Thread Directory Service ■ ste.c 
feO8Qi[00160] Program Listing 4.3 ■ Thread Directory Service - log.c 
|Q0834[00161] P rogram Listing 4.4 Thread Directory Service - ice 
feQ88^[00162] P rogram Listing 4.5 thread directory service • set_blocking.c 
feQ8^[00163] P rogram Listing 4.6 thread directory service - set_nonblocking. 
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fe08^[00164] P rogram Listing 4.7 thread directory service - Makefile 
feQ86^[00165] P rogram Listing 5.0 fopen service - fopen.c 
feQ8^[00166] Program Listing 6.0 fscanf service ■ fscanf.c 
•teQ8?^[00167] Program Listing 7.0 fclose service - fclose.c 

■feQ88^[00168] ^Program Listing 8.0 caps service caps.c 

feQ89i[00169] ^Program Listing 9.1 generic firont end loader service gfel.c 

feQ9Ql[00170] Program Listing 9.2 generic front end loader service client_gl.c 

feOft34[0017l] Program Listing 9.3 generic fi-ont end loader service client_gl2.c 

•feQftal[00172] Program Listing 9.4 generic firont end loader service gl3.c 

teQ03l[00173] ^Program Listing 10.1 thread connection service - talk2.c 

feQftti[00174] ^Program Listing 10.2 thread connection service ■ participant. c 

feQ96i[00175] Program Listing 10.3 thread connection service ■ tcp_accept2.c 

feO9^[00176] ^Program Listing 10.4 thread connection service - tcp_connect.c 

•tQQ974[00177] Program Listing 10.5 thread connection service - tcp_listen.c 

teQ08i[00178] ^Program Listing 11.1 supporting functions " reaper. c 
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■feQ9rt[00179] Program Listing 12.1 supporting service ■ cat_service.c 

[0 100] Program Listing 12.2 supporting service ■ echo_service.c 
[0101] Program Listing 12.3 supporting service ■ daytime_service.c 
[0102] Program Listing 12.4 supporting service ■ ksh_service.c 
[0103] Program Listing 12.5 mail service - mail_service.c 
[0104]Program Listing 13.1 TDS supporting functions - tds_query_p.c 
[0105] Program Listing 13.2 TDS supporting functions ■ tds_registerj).c 
[0106] Program Listing 13.3 TDS supporting functions ■ getdtscinfo.c 
[0107] Program Listing 13.4 TDS supporting functions ■ tds.c 
[0108] Program Listing 14.0 process function - cps.c 
[0109] Program Listing 14.1 process function - cps2.c 
[Olio] Program Listing 14.2 process function ■ cps3.c 
[Olll] Program Listing 15.0 stateful service - main.c 
[0112] Program Listing 15.1 stateful service ■ tcp_accept.c 
[0113] Program Listing 15.2 stateful service " tcp_listen.c 



Page 16 of 229 



Marked-Up Version of Subsitute Specification 
Application 10/068,077 

[01 14] Program Listing 15.3 stateful service - getaddrinfo.c 

[0115] Program Listing 16.1 ■ File SERVICESl Service prototype table. 

[0116]Program Listing 16.2 - File SERVICES2 Service prototype table. 

[0117] Program Listing 16.3 ■ File SERVICES3 Service prototype table. 

[01 18] Program Listing 16.4 ■ Command line to generate data dictionary from 
prototype table 

[0119] Program Listing 16.5 • Generated Data Dictionary 

[0120] Program Listing 16.6 ■ Services2 prototype table 

[0121] Program Listing 16.7 - Generated Data Dictionary for Services2 

[0122] Program Listing 16.8 - Providers prototype table 

[0123] Program Listing 16.9 ■ Providers generated data dictionary 

[0124] Program Listing 16.10 - Cymbal instructions to insert record 

[0125] Program Listing 16.11 ■ Cymbal instructions to report registration entry 
information 

[0126] Program Listing 16.12 - Global Definitions 
[0127] The Architecture 
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[0128] The Internet is a network linking computer systems together and 
communicating via a standard protocol. A computer network is simply a collection 
of autonomous computers connected together to permit sharing of hardware and 
software resources, and to increase overall reliability. The qualifying term "local 
area" is usually applied to computer networks in which the computers are located in 
a single building or in nearby buildings, such as on a college campus or at a single 
corporate site. When the computers are further apart the term "wide area network" 
may be used. 

[0129] As computer networks have developed, various approaches have been used in 
the choice of communication medium, network topology, message format, protocols 
for channel access, and so forth. Some of these approaches have emerged as de facto 
standards, but there is still no single standard for network communication. The 
Internet is a continually evolving collection of networks, including Arpanet, 
NSFnet, regional networks, local networks at a number of university and research 
institutions, a number of military networks, and increasing, various commercial 
networks. The protocols generally referred to as TCP/IP were originally developed 
for use through Arpanet and have subsequently become widely used in the industry. 
The protocols provide a set of services that permit processes to communicate with 
each other across the entire Internet. 

[0130] A computer can be a mainframe, minicomputer, microcomputer, or any of a 
number of other computing devices. In the case of the present invention, the 
computer should be able to communicate with the outside world. Therefore, for 
example, a first generation microwave oven controller using a Z-80 chip would not 
be able to use the invention, but it is conceivable that providing a communications 
capability to a microwave controller woidd enable it to use the invention. A number 
of different computing devices are able to communicate with the outside world while 
computing. Such devices include set top boxes, PDAs (personal digital assistants), 
and cellular phones using CDMA or similar technologies. 
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[0131] Likewise, a server is traditionally at a fixed location; however it is possible to 
provide a server in any of a number of forms. The server can be running as a client 
of another server and in fact it is often the case that a computing device may be a 
client to another device which functions as a host, and yet perform server functions 
for that other device. 

[0132] A model for network architectures has been proposed and widely accepted. It 
is known as the International Standards Organization (ISO) Open Systems 
Interconnection (OSI) reference model. The OSI reference model is not itself a 
network architectiure. Rather it specifies a hierarchy of protocol layers and defines 
the function of each layer in the network. Each layer in one computer of the 
network carries on a conversation with the corresponding layer in another computer 
with which communication is taking place, in accordance with a protocol defining 
the rules of this communication. In reality, information is transferred down firom 
layer to layer in one computer, then through the channel mediimi and back up the 
successive layers of the other computer. However, for purposes of design of the 
various layers and understanding their functions, it is easier to consider each of the 
layers as communicating with its counterpart at the same level, in a "horizontal" 
direction. (See, e.g. The TCP/IP Companion, by Martin R. Arick, Boston: QED 
Publishing Group 1993, and U.S. Pat. No. 5,159,592. These, and all patents and 
publications referenced herein, are hereby incorporated by reference.) 

[0133] The lowest layer defined by the OSI model is called the "physical layer," and 
is concerned with transmitting raw data bits over the communication channel. 
Design of the physical layer involves issues of electrical, mechanical or optical 
engineering, depending on the medium used for the communication channel. The 
second layer, next above the physical layer, is called the "data link" layer. The main 
task of the data link layer is to transform the physical layer, which interfaces 
directly with the channel medium, into a communication link that appears error- 
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free to the next layer above, known as the network layer. The data link layer 
performs such functions as structuring data into packets or frames, and attaching 
control information to the packets or frames, such as checksums for error detection, 
and packet numbers. 

[0134] The Internet Protocol (IP) is implemented in the third layer of the OSI 
reference model, the "network layer," and provides a basic service to TCP: 
delivering datagrams to their destinations. TCP simply hands IP a datagram with 
an intended destination; IP is unaware of any relationship between successive 
datagrams, and merely handles routing of each datagram to its destination. If the 
destination is a station connected to a different LAN, the IP makes use of routers to 
forward the message. 

[0135] The basic function of the Transmission Control Protocol (TCP) is to make 
sure that commands and messages from an application protocol, such as computer 
mail, are sent to their desired destinations. TCP keeps track of what is sent, and 
retransmits anything that does not get to its destination correctly. If any message 
is too long to be sent as one "datagram," TCP will split it into multiple datagrams 
and makes sure that they all arrive correctly and are reassembled for the 
application program at the receiving end. Since these functions are needed for 
many applications, they are collected into a separate protocol (TCP) rather than 
being part of each application. TCP is implemented in the "transport layer," namely 
the fourth layer of the OSI reference model. 

[0136] Except as otherwise is evident from the context, the various functions of the 
present invention reside above the transport layer of the OSI model. The present 
invention may be used in conjunction with TCP/IP at the transport and network 
layers, as well as with any other protocol that may be selected. 
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[0137] The OSI model provides for three layers above the transport layer, namely a 
"session layer," a "presentation layer," and an "application layer," but in the 
Internet these theoretical "layers" are undifferentiated and generally are all 
handled by software. 

[0138] Internet Firewall 

[0139] A security system placed between the Internet and an organization's network 
(such as a LAN) to provide a barrier against security attacks. Internet firewalls 
typically operate by monitoring incoming and/or outgoing traffic to/fi-om the 
organization's network, and by allowing only certain types of messages to pass. For 
example, a firewall may be configured to allow the passage of all TCP/IP traffic 
addressed to port 80, and to block all other traffic. For more information of Internet 
Firewalls, see Chapman and Zwicky, Building Internet Firewalls, O'Reilly 
publishing, 1995 (ISBN 1-56592-124-0). 

[0140] Computer systems having access to the Internet, can have a dynamic 
Internet Address assigned to them. The Internet Firewall can be configured to 
perform network address translation as defined in "Network Working group 
Request for Comments 1631, and Request for Comments 3022." 

[0141] A computer system having access to the Internet can be assigned a private 
Internet Address, as defined in Request For Comments 1597. 

[0142] Component of Software 

[0143] A basic principle of the invention is that of a component of software. The 
term component of software is deliberately chosen to indicate that less then an 
executable program may be used. By way of example, but not hmitation, a 
component of software can be* 
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- an executable program 

- an executable program linked with shared libraries, dynamic link 
libraries, or other such libraries as would be provided for in an 
embodiment 

- an object as one would understand in using remote procedure call 

- an object as one would understand in using the Microsoft Component 
Object Model or other such industry standard 

- a dynamically loadable module such as a module in a shared hbrary 
(also called dynamic link library on Microsoft Windows) or other such 
library as defined by the operating system or embodiment 

- a function that is called by a dynamically loadable hbrary initiahzation 
function, such as occurs with the use of a Microsoft's Windows DLL. In 
such cases, a DllMain function may be called when a thread (either a 
process, or a thread created by the process) attaches to the hbrary. 
Initiahzation functions are also accessible through KornShell and 
other such processes. The initiahzation function may therefore 
perform the functionahty required of the component of software 

a software assembly as defined in the Microsoft C# Language 

- a builtin function of a shell program such as the KornShell 

- a function of an interpretive language processing element, such as a 
KornShell function, shell function, or a perl function. 

- a shell script as defined by a sheU program such as the KornShell or 
other interpretive language processing element. 

- a script that is interpreted by another process such as that which is 
used by BASIC, Kornshell, Csh, Tcsh, Perl, Tcl/Tk, or other such 
interpreter 

■ a module which is then hnked into an executable with a just-in-time 
compiler 

- a byte stream which is communicated to an interpreter such as that 
which is available with KornSheU, Java 



Page 22 of 229 



Marked-Up Version of Subsitute Specification 
Application 10/068,077 



• a data stream which is communicated to an interpreter process 

[0144] Note that when used with the invention, the component of software may 
require the use of a generic front end loader process that initializes an address 
space. By way of example, but not limitation such a generic front end loader could: 

• accept command line parameters identifying the component of 
software to be used, or 

" determine such information by accessing a configuration, or 

accessing a memory location accessible to the generic front-end loader, 
or 

- commimication with a second process providing such information, or 

- accessing and interacting with a directory service process, or 

- accessing and interacting with a component of software to determine 
such information, or 

- communicating with a second process to determine such information, 
or 

- use inter-process communications to determine such information, or 
use intra-process communications to determine such information, or 
use operating system interfaces providing such information, or 

use an application programming interface to determine such 
information, or 

- use a combination of the above to determine such information. 

[0145] Note that when the component of software is provided by a data stream 
interpreted by an interpreter, then the data stream may require a local process to 
communicate with an accessible process in order to facilitate the data stream. By 
way of example, but not limitation, such a data stream may be communicated from 
an Internet Address and Port as one would understand when using the socket 
application programming interface, or equivalent thereof. Alternative network 
Application Programming Interfaces can be used (See the discussion on 
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communications for examples). Such an implementation would require connecting 
to the process at the specified network (which could include an Internet Address 
and port), possibly communicating a request to the connected process, and receiving 
a response wherein the response communication includes the data stream. 
Alternatively, by way of example, such a data stream may be communicated fi-om a 
process accessible through communications over the Internet wherein the process is 
defined by a Universal Resource Location (URL) as in 
http7/www.gtlinc.com/proc/stream or equivalent thereof. 

[0146] A device driver can be used. Either one provided through the operating 
system interfaces, or, one provided by an application operating environment such as 
the AST ToolKit. By way of example, but not limitation, an implementation can use 
an open system call to open a device such that by accessing and interacting with the 
device, information such as that required for facilitating the methods, can be 
achieved. By way of example, a process issues- 

[0147]fp=fopen("directory service", "rw"); 

[0148] The process opens a device caUed directory service. As this may not be an 
operating system device, the fopen implementation determines how to access and 
interact with the device based on the device name specified. See function call and 
system calls for details on implementing augmented functions. 

[0149] A component of software can be installed on the computer system, or 
accessible to the computer system through the network. A user, such as a 
consumer, or a service provider, can cause the software to be installed. This can 
include the use of software downloaded fi'om the network, as weU as software that 
is preinstalled on the computer system as purchased, or software that is installed 
during the installation of the operating system or component thereof. The 
component of software downloaded from the network may require an installation 
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process to be executed, which then installs on the computer such that it can be 
executed. By way of example, but not limitation, a first component of software 
downloaded can be compressed and require decompression, resulting in an 
executable that then installs one or more components of software on the computer 
system. Examples would include such techniques as downloading an InstallShield 
package, a Java component, a C# Assembly or other such techniques as known in 
the industry. 

[0150] One or more programming languages and programming techniques can be 
used to create various embodiments of the invention, and the invention can be 
implemented on various operating systems such as AIX, BSD, Linux, HP-UX, 
Solaris, UNIX, IRIX, OpenEdition, UnixWare, and Windows. 

[0151] A component of software can provide a service for a daemon process listening 
on a particiilar network endpoint, such as Internet Address and port (i.e. 
192.127.0.3 port 80). In such cases, the information communicated to the daemon 
process will be used by the daemon process to cause the service to be executed. 
According to US Patent 5,850,518, the service can be dynamically loaded, or can be 
executed in a manner in which the daemon process connects to the service via a 
communication Hnk. Such cases may be necessary to provide the desired 
functionality. 

[0152] Program Listing 15.0 through 15.3 provide an embodiment using a main 
program that accepts command line parameters indicating the type of primitive to 
use, the internet address and port, and the name of the service to load. The service 
is dynamically loaded &om the libservices.so.1.0 library. Each time a connection is 
received, the service is invoked. 

[0153] Application Service 
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[0154] An application is said to provide a primary service. The application may also 
offer one or more minor services. The primary service, along with any minor 
services, collectively constitute the application service. By way of example, an 
application such as the Netscape Communicator can provide a primary service of 
graphically rendering HTML documents. A minor service offered by the Netscape 
Commimicator is a Messenger for administering (such as creating, sending, 
receiving, deleting, cataloging, viewing, forwarding, editing) electronic mail. A 
second minor service offered by the Netscape Communicator is a Composer for 
creating new HTML documents or editing existing documents. One skilled in the 
state of the art woidd understand that the a first user of an application coidd 
perceive the application as providing a primary service that is different firom a 
second user of the same application. 

[0155] Minor Service 

[0156] A minor service provides some functionality towards the overall application 
service. The Minor Service is implemented through a component of software. When 
used in an active context, it is understood that the term Minor Service refers to the 
process executing the component of software. When used in the inactive context, 
the minor service refers to the component of software. Thus one would understand 
that a minor service is provided by a component of software and when the 
application requires interaction with the minor service, then the minor service is 
executing. 

[0157] Service 

[0158] A service is provided for by a component of software. A service may be a 
minor service, or a primary service. A service can be a primary service of a first 
application service, and a minor service of a second application service. A service 
can be a service to itself. By way of example, a service can be implemented as a 
first process which then issues a forkO system call to create a child process. 
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[0159] In standard UNIX environments, its it standard coding technique to create a 
daemon process listening for requests for services on a particular Internet Address 
and port. When a client connects to the specified port, then the daemon process wiU 
tjrpically accept the connection, and then issue a fork function call. The fork 
function creates a child process. The original daemon process, called the parent 
process, remains executing. The child process typically closes its standard input, 
standard out, and standard error file descriptors. The child process then duplicates 
the file descriptor (or handle) associated with the accepted connection, as the new 
standard input, standard output, and standard error file descriptors. The child 
process then tjrpically issues an exec function call. The exec function call overlays 
the image of the current process with a new image of a new executable program to 
be executed. The child process typically performs whatever action is necessary, and 
then exits. 

[0160] There are cases, however, where the process providing the service may need 
to stay executing even after responding to the first requesting process. Different 
methods can be used. One method is for the first process to accept the connection, 
perform the desired service, and respond to the requesting process. In this manner, 
whatever state changes where made to the first process remain intact, and are 
available to subsequent processes. A second method is for the first process to create 
the child process, and to have the child process remain executing. In this manner, 
the changes made to the state of the child remain intact. For subsequent 
requesting processes to gain access to such state information, the child process 
provide means to permit the subsequent requesting process to access and interact 
with the child, which may include having the child connect to the requesting 
process, or, having the requesting process connect to the child, or both. An example 
of where such state information is useful to retain is when the service is to provide a 
function or system caU on behalf of a requesting process. There are cases where the 
result of the function or system call must be retained by the service and accessible 
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to subsequent requesting processes (which coiQd be the same requesting process 
later accessing and interacting with the service). By way of example, a first 
requesting process sends a request to a service to perform a file open function call. 
The service perform the open function call and has associated therewith a file 
descriptor (or handle). The service provides the results to the requesting process. 
The requesting process then disconnects. A requesting process later accesses and 
interacts with the service, providing the service with the previous response 
indicating the results of the open function call. The requesting process provides a 
request indicating the service is to read a string from the file descriptor. The 
service, still having the file descriptor open, performs the read and returns the 
results thereof to the requesting process. 
[0161] Application Process 

[0162] The term application process, as used in this document, refers to the overall 
computer representation of the application service. In this definition, the term 
application process is defined to incorporate all processes of various "weight" 
including, but not hmited to, heavy weight, medium weight, and light weight 
processes relating to the application service. A heavyweight process executes in its 
own address space, whereas medium-weight and light-weight processes may 
execute within the same address space. The application process may constitute one 
or more of these processes. Each of these processes is said to have a thread of 
execution. 

[0163] A thread, in this context, represents an execution stream of the application 
process. The notion of a thread can be provided by the underlying operating 
system, referred to as kernel-supported threads, or can be provided at the 
application level, referred to as user-level threads, or can be a mixture of the two. 
For the purposes of this description, these will collectively be referred to as threads. 
Note that in a distributed environment, one or more of these threads may be 
executing on a remote computer system. 
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[0164] The application process may be confined locally to the computer system on 
which the application process was initially started, or may have its execution 
threads distributed among various computer systems accessible to the computer 
system on which the application process was initially started. 

[0165] When a user of the computer system requests to execute an application, a 
corresponding program is loaded into the computer's memory and a single thread of 
execution begins. This initial thread may then create additional threads on the 
local computer system, or possibly on a remote computer system, such as that which 
would occur with remote procedure call implementations, Microsoft COM, Microsoft 
DCOM, or other such industry standard techniques. 

[0166] The creation of a new thread requires the starting point of the new thread to 
be specified. In procedural computer languages, for example, this would require the 
requesting thread to specify the address of the procedure to begin as a new thread. 

[0167] Communication Devices 

[0168] A computer system includes a communication device. By way of example, but 
not limitation, a communication device can be a modem, a network card, a RFC 
device, an infrared device, an optical device, a wireless device, a device connecting 
the computer to a public switching system device, such as that provided for by a 
telephone carrier, a Tl connection or equivalent thereof, or any such device for the 
purpose of facilitating communication between one or more computer systems. All 
such devices are referred to as communication devices. 

[0169] A process can listen on a communication device, awaiting a communication. 
By way of example, but not limitation, a process can be considered a daemon 
process, such as that provided by inetd on a UNIX implementation, or other such 
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process, and await a communication. When a communication is received, the 
process can accept the connection and then send communications, receive 
communications, or otherwise interact with the communication as appropriate. 

10170] A process that is listening on a communication device generally has a fQe 
descriptor open associated with the device. Certain embodiments, such as that with 
the Microsoft Windows operating system environment, can alternatively use a 
socket handle to listen on the device. Note, however, that with the UAVIN 
environment available from Global Technologies Ltd., Inc., the code would refer to a 
file descriptor that is then translated to a handle for the underlying operating 
system. 

[0171] When a process accepts a connection, the process can cause a second process 
to begin executing. Alternatively, the second process may already be executing. In 
either case, the first process can inform the second process of the file descriptor, or 
handle, that the first process accepted the communication connection on. Various 
techniques are available to implement this. By way of example, but not Umitation, 
the first process can cause the second process to be created and the file descriptor, 
or handle, can be inherited by the second process. Alternatively, the first process 
can open the second process and duplicate the handle from the first process to the 
second process. Alternatively, the second process can open the first process and 
duplicate the handle fi-om the first process to the second process. Alternatively, the 
first process can use file descriptor passing techniques to pass the file descriptor or 
handle to the second process. 

[0172] Communication 

[0173] Interprocess, Intraprocess, and network communications are supported. 
Communication from a first process executing on a first computer to a second 
process executing on a second computer requires the use of a communication device. 
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The operating system typically provides interfaces for communication connectivity 
and synchronization in using such communication devices. The operating system 
interfaces generally provide for a connect/send/receive/disconnect capability. Note, 
though, that a device can be referenced with equivalent functionality using an 
open/write/read/close interface, or some other interface as provided for by 
intermediary components of software providing equivalent functionality. 

[01 74] By way of example, but not limitation, the socket application programming 
interface can be used to facilitate communicate. On the Microsoft Windows 
operating system, equivalent Win32 Application Programming Interfaces can be 
used. 

[0175] It is expressly understood that when a first process communicates with a 
second process, the communication may be sent by the first process on a first 
computer to a second process on a second computer and that such communication 
may be sent through intermediary computer systems on the network. Thus the 
communication from the first computer may be processed by one or more 
intermediaries before arriving at the final destination which is the second process. 

[0176] It is expressly understood that when a first process communicates with a 
second process, the communication can be sent by the first process to a process 
executing on a second computer, and that this process can cause the communication 
to be made available to the second process. By way of example, but not limitation, 
the phrase "a first process sends a communication to a second process" can be 
understood as the first process sends a communication to a daemon process which 
receives the communication, causes the second process to begin executing, and 
causes the communication to be accessible to the second process. By way of 
example, but not limitation, the phrase "causes" can be interpreted as the process 
provides the second process with the file descriptor or handle, or, the process 
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receives the communication and uses interprocess or intraprocess communications 
to make the communication available to the second process. 

[0177] As provided for by US Patent 5,850,518 patent, a process can create a thread 
to perform the communication. By way of example, but not limitation, a first 
process can create a reader thread to receive a communication firom a second 
process. When a message is received by the reader thread, the first process is 
notified and can access and interact with the message. 

[0178] Various forms of encryption, message scrambling, or other such techniques 
can be used by the implementation to add additional layers of security as required 
by the implementation. 

[0179] Content and Format 

[0180] The term commimicate implies content. It is further understood that the 
format of the content of the communication can be defined by the embodiment. By 
way of example, but not limitation, formats such as HTML, SGML, XML, schema 
information, data type information, name value pairs, text, or even components of 
software fabricated to convey the information. A shell script, for example, can have 
variable names and values to convey information. The only Umitation is that the 
participants in the conversation must have a method to communicate the necessary 
information. This may, for example, include the use of various filters or translation 
services to transpose the communicated content from a first format to a second 
format, and possibly from the second format back to the first format. A multiplicity 
of formats may be used along the path as the communicated content moves along 
the network. 

[0181] One skilled in the state of the art would understand that content could be 
expressed according to rules of grammar. For example, a scripting language such 
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as KornShell, or Perl, or Tel, or Tk, employ particular grammatical rxxles. It is 
understood that the content can be formatted according to a language's 
grammatical rules. 

[0182] Furthermore, content can be fQtered through various filtering techniques as 
defined by the implementation. 

[0183] Furthermore, content can be verified through various verification techniques 
as defined by the implementation. By way of example, but not limitation, the 
verification can be implemented through one or more of 

- the use of XML facets 

■ the use of components of software such as that provided for by the 
Daytona Data Management system 

- the use of a binding service, such as that provided for by the methods 
of US Patent 5,850,518 

- the use of industry standard protocols 

- the use of industry standard specifications. 

[0184] Protocols 

[0185] Communication implies the use of a protocol. A protocol defines a set of rules 
for communication. Protocols such as TCP, HTTP, FTP, computer mail protocols, 
application defined protocols, industry standard protocols, proprietary protocols, 
and the likes can be used. Once skilled in the state of the art would understand 
that various protocols could be developed in the future which can also be used for 
such communication. Furthermore, a multiplicity of protocols may be used as 
required. By way of example, but not limitation, protocols such as SOAP (Simple 
Object Access Protocol) can be used in conjunction with transport protocols such as 
HTTP. From the standpoint of the invention, all such protocols are contemplated 
for and coDectively referred to as a protocol. 
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[0186] Consumer Service 

[0187] The term consumer is meant as a consumer of a service. The service 
consumed can be an on-line service such as banking, electronic commerce, data 
acquisition, news reports, a service describing something of interest, changes to a 
web site, changes to a catalog, changes to what is available on-line, or even an 
online service such as that provided by an Internet Service Provider. Regardless, 
though, the service is provided by at least one component of software. A person, 
acting as a consumer, can also provide a service and such a service is referred to as 
a consumer service. In such cases, the consumer service is provided by a component 
of software. 

[0188] A consumer causes a component of software to be installed on the computer 
system wherein the component of software provides a consumer service. 
Alternatively, the component of software can be pre-instaUed by a provider of such 
computing device as one may anticipate when purchasing a computer from a 
provider such as Compaq, DeU, or Gateway. Alternatively a component of software 
can be downloaded from the network which implies the use of transferring the 
component of software from a first computer to a second computer, the second 
computer representative of the computer system being used by the consumer. 

[0189] Registry 

[0190] The term registry is understood to imply a collection of related data. The 
term service directory could be used as well. The embodiment can use a database, a 
data management system such as the Daytona Data Management System from 
Global Technologies Ltd., Inc., a directory service, an ascii text file, a binary file, an 
indexed file, an industry standard method of organizing data, a method for 
administering data as provided for by an operating system, or other such techniques 



Page 34 of 229 



Marked-Up Version of Subsitute Specification 
Application 10/068,077 



as would be understood in the state of the art, to facilitate the administration and 
administrative functions required. Such administrative functions can include one 
or more of collecting, organizing, accessing, interacting, verifying, replicating, or 
indexing of such information. A minimum administrative functionality set should 
include the ability to register, query, and delete. Additional administrative 
functionality would include the ability to change, update, or otherwise modify 
existing data. Within this specification, a directory service constitutes the 
application service for administering the data in the registry. When implemented 
with the Daytona Data Management System, a multiplicity of individual programs, 
libraries, applications can collectively constitute the directory service. 

[0191] In a preferred embodiment, the Daytona Data Management System would be 
used instead of a commercial database system such as Oracle. The distinction is 
that Daytona provides full database capability in the development environment, 
and supports a runtime environment without the capability to define or add new 
tables and new schemas. A Daytona runtime environment has a significantly lower 
cost then comparable database systems such as Orcale or Informix, and does not 
require the customer to hire a database administrator. The Daytona system is 
specialized for run time applications needing data management, without the 
overhead of a Oracle or Informix. 

[0192] Multiple registries can be used, and the registries may reside on different 
computers of the network. In one sense, this can be used to provide collections of 
services based on geographic areas. By way of example, a first registry contains 
entries representative of service providers providing service only within the state of 
New Jersey. A second registry contains entries representative of service providers 
providing service only within the state of New York. One skilled in the state of the 
art would understand that both registries could reside on a single server located in 
Connecticut, or on a first server in New Jersey and a second service in New York. 
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[0193] The organization of the data within the registry can be defined by a schema, 
as one skilled in the state of the art would understand the term schema. By way of 
example, a database consist of one or more tables, each table has a schema. An 
XML document may have a schema defining the content. A data management 
system provides the use of schemas for defining the content of a data set. The 
organization of the data within the registry can include a multipUcity of schemas. 
Thus a first data set having a first schema, and a second data set having a second 
schema, wherein the first data set and the second data set can be logically related to 
the task at hand. 

[0194] An embodiment can use one or more in-core tables to faciUtate the registry. 
Such techniques are known in the state of the art and are provided for with the 
Daytona Data Management System from Global Technologies Ltd., Inc. See the 
Daytona User's Guide for details. 

[0195] The registry can include encrjrpted or compressed data and that this is 
implementation issue. When using the Daytona Data Management System, for 
example, a record class description can include compressed fields. From the 
services viewpoint, however, the data is uncompressed until saved by Daytona in a 
compressed format. Similarly, when the service requests data, the data may be 
decompressed by Daytona and provided to the service in an uncompressed format. 

[0196] The registry can be implemented using horizontal and, or, vertical 
partitioning techniques. See the Daytona Users Guide for details. 

[0197] Administrative functions can be implemented through access methods [access 
plans] as one wotdd understand the term in database techniques. By way of 
example, but not limitation, a SQL statement can be used. The implementation, 
possibly through the use of an ODBC Compliant Driver, (or JDBC Compliant 
Driver) can create an access plan for accessing and interacting with the data. 
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Similarly, a Daytona Cymbal statement can be compiled into object code and the 
object contains the access method. 

[0198] Administrative functions can be implemented through a 4th generation 
language such as that of Cymbal, as provided by the Daytona Data Management 
System [see Daytona's User Guide], 

[0199] An embodiment can use one or more components of software to facilitate 
administering the registry. In such content, the components of software can 
communicate as reqiiired by the embodiment. By way of example, a first component 
of software on a first computer can communicate with a second component of 
software executing on a second computer to facilitate an administrative function. 

[0200] The schema can be implemented through the techniques of the Daytona Data 
Management System. The term Record Class Description equates to a schema. A 
component of software can include the access method for accessing and interacting 
with the registry. 

[0201] The registry can be implemented as a Daytona Project and that one or more 
administrative functions can be implemented through a first Daytona Application, 
while additional administrative functions can be implemented through a second 
Daytona Application. A Daytona Application has one or more Record Class 
Definitions. See Daytona's User Guide]. 

[0202] A registry entry can consist of a multiplicity of information components, and 
an information component can have an attribute describing the use of the 
information component. By way of example, but not limitation, an attribute can be 
PUBLIC, in which case the information component is available to any requesting 
process. An attribute can be PRIVATE in which case the information component is 
only accessible to the entity requesting the registration in the registry. An attribute 
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can be SECURE, in which case the information component is accessible to a process 
satisfying security criteria as defined by the implementation. In the use of 
attributes, a more robust implementation would define a service associated with the 
attribute such that the service can be invoked as necessary to perform the 
functionality desired. By way of example, but not limitation, the PRIVATE 
attribute can have an associated PRIVATE service that is called by the service 
accessing the registry, to perform the validation, parsing, filtering, or otherwise 
data manipulation required to fulfiU the functionality of the service. One skilled in 
the state of the art would understand that such functionality and management of 
attributed field capability coidd be implemented with the Daytona Data 
Management System. 

[0203] Program Listings 4.1 through 4.7 provide an embodiment of a directory 
service. The directory service is started by the generic front end loader, and Ustens 
on an Internet Address and port for requests. The directory service reads 
name/value information components, and acts upon them according to the specified 
command. The directory service configures the command table during 
initialization. In the current embodiment, the commands register, create, query, 
and delete are registered with the directory service. In a second embodiment, 
additional commands can be registered such as update, modify, replicate, report, 
and others. In a third embodiment, the commands to be registered can be read firom 
a configuration file, such as that used by the software engine service. In yet 
another embodiment, the commands to be registered can be queried from a common 
directory service. The directory service accesses the request, and locates the 
command information component. The directory service then locates the 
corresponding registered command and accesses and interacts with the service 
associated with that command. By way of example, if the command is register, then 
the directory service locates the service associated with the register command and 
accesses and interacts with that service. In the embodiment of Program Listings 
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4.1 through 4.7, the directory service recognizes the ".private" attribute of an 
information component and treats such information components accordingly. 

[0204] Note that an embodiment of the first directory service can access and interact 
with a second directory service to determine services to be provided by the first 
directory service. By way of example, the first directory service can communicate a 
request for services to the second directory service, and the second directory service 
can access and interact with the request to determine an appropriate response. The 
response may include one or more accessible services. This permits a first directory 
service to be configured according to the criteria suppHed by the first directory 
service to the second directory service. In this regard, the first directory service 
may have a subset of services that the second directory service supports. By way of 
example, the first directory service may support a query command, but not a 
register command. Similarly, the first directory service may support an update 
command, but not a delete command. By way of example, the first directory service 
communicates a unique identifier associated with a service provider to the second 
directory service. The second directory service, responsive to receiving the 
identifier, accesses and interacts with the registry and determines the unique 
identifier has a particular security level associated with it. As a result, the second 
directory service communicates a response indicating one or more commands, and 
one or more services associated with each command, to the first directory service. 
Subsequent use of the first directory service would then be limited to those 
commands supported by the first directory service. 

[0205] A multiplicity of registries can be maintained by the embodiment. Each 
registry can be accessed by a corresponding directory service. A multiphdty of 
directory services can be used. Each directory service can broadcast its availability. 
Such an implementation would use standard broadcasting techniques as defined in 
UNIX Network Programming series, Second Edition, W. Richard Stevens, Addison 
Wesley, ISBN 0- 13-4900 12 X, or equivalent thereof. By way of example, a first 
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directory service of a first computer of the network can broadcast its availability. A 
second directory service of a second computer of the network, responsive to 
receiving the broadcast from the first directory service, can register the first 
directory service with the second directory service. Alternatively, the first directory 
service could access and interact with the second directory service to cause the 
second directory service to register the first directory service. 

[0206] The unique identifier 

[0207] The term the unique identifier implies a sequence of characters used to 
uniquely qualify an entity. In this context, the term entity can represent a 
consumer, a service provider, a transaction, an entry in a registry, a thread, a 
process, a function, or a component of software. The reader will be guided by the 
context of the term to determine the corresponding entity referenced. For example, 
a consumer the unique identifier is understood as an identifier imiquely qualifying 
a consumer from other such consumers. A service provider the unique identifier is 
understood as an identifier uniquely qualifying the service provider firom other such 
service providers. 

[0208] The identifier can be a string of characters in the character code set 
understood by the embodiment. The identifier could contain white space. 

[0209] An embodiment can use a mtdtiplicity of strings to ensure uniqueness. For 
example, an identifier can include a first string and a second string as in^ 
[0210] IDENTIFIER: Northrup, C, 15 Spring Street, Suite 200, Princeton, NJ 

[0211] In this context, the uniqueness may require a multiplicity of information 
components such as Name, Address, City, State. 
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[0212] When used in conjunction with a Universal Description Discovery and 
Interchange Node (UDDI), a uddi_key can be used as the unique identifier. 

[0213] When used in conjunction with a hashing service, the registration 
information, or a portion thereof, provided by the subscriber [ie., the consumer] can 
be communicated to the hashing service to generate a hash key. 

[0214] The unique identifier can include a name value pair, or a multiphcity of name 
value pairs. This is especially useful when using a directory service to create an 
entry in the registry. By way of example, a unique identifier can include a first 
name and value indicating a specific data set (or registry) or logically related data 
sets. The second name and value pair can indicate a unique key within the data 
set. By way of example, a unique identifier "sd=payment_services 
id=cjn@gtlinc.com" would indicate that the service directory (ie. The registry) is 
called payment_services and id=cjn@gtlinc.com is within that registry. 

[02 15] A given person may have a multiplicity of the unique identifiers, each the 
unique identifier uniquely qualifying the person with respect to the activity the 
person is performing. A person at work may have one the unique identifier for work 
related activities, a separate identifier for home (or personal) related activities, and 
a separate identifier for organization activities (such as non-profit organization, 
little league, home-school association, political party activities). Note that a person 
may have the unique identifiers for other activities within an activity. 

[0216] A user may interact with a component of software on the user computer to 
select the current the unique identifier as appropriate for the current activity. The 
interaction may be through means of a touch screen system, a pointing device such 
as a Microsoft mouse, speech recognition apparatus, and the like. Regardless of the 
implementation, software will be used in determining the current the unique 
identifier. The interaction may cause software to determine the activity and from 
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the activity determine the unique identifier. The aforementioned may be 
determined solely by a process monitoring the activity of the user, by a process 
determining the activity of the user, or, by prerecorded information accessible to the 
process. Furthermore, such process may require interaction or communication with 
a second process as in the case of a first process communicating with a directory 
service. 

[0217] When the computer system uses the named execution environment of US 
Patent 5,850,518, then a process can register attributes with the directory service. 
In such cases, a first user may have access to a first computer, which registers 
attributes describing a first process on the first computer. The implementation can 
use this information to deduce or otherwise determine the activity, or, the current 
the unique identifier, or a combination thereof. When the first user uses a second 
computer, then a process on the second computer can register attributes with the 
directory service. In such a case, the first user's activity or the unique identifier, or 
combination thereof, can be determined by the registered attributes of the second 
computer. 

[0218] When the invention is used with the methods of US Patent 5,850,518, then a 
first process of the user's computer can communicate with a directory service to 
determine the current activity or the unique identifier, or combination thereof. 

[0219] An implementation can use a unique identifier associated with a user, 
combined with access and interaction rights based on the network endpoint that the 
user is connecting fi"om, to determine privilege and authorization. By way of 
example, a business maintains an enterprise wide network. An employee has an 
assigned the unique identifier. The employee uses a computer connected directly to 
the enterprise wide network (i.e., an ethernet behind a firewall). The employee 
provides their the unique identifier and can access and interact with a service 
within the enterprise (ie., behind the firewall). The employee leaves the office and 
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goes home. From home, the employee uses an Internet Service Provider, such as 
America On-line, to access the Internet. A process on the employee's home 
computer, connects to the enterprise service executing behind said firewall. The 
employee provides their the unique identifier. The enterprise service uses an 
authentication service and determines that the computer the employee is 
connecting fi"om is outside of the enterprise wide network. The enterprise service 
then permits the process executing on the employee's computer to access and 
interact with a Umited set of services. The limited set of services may be pubHcaUy 
available services that are provided by the enterprise. For example, an 
administrator within the enterprise may configure the services such that access to 
customer information wiU only be granted to a requesting process executing within 
the enterprise, but, access to the company phone directory is permissible for 
requesting processes executing outside of the enterprise. 

[0220] Dynamically Loadable Modide 

[0221] A dynamically loadable module is a component of software stored in a shared 
library, or a dynamic link library, or equivalent thereof, but collectively referred to 
as shared library throughout this specification. In a typical embodiment, a first 
function call is made to attach the shared library to the address space of the 
requesting process. A second function call is then made to access a particular 
module within the shared library. It is noted that certain embodiments can take 
advantage of an initialization function within the shared library that is 
automatically invoked when the shared library is attached or detached. Examples 
of this are the DllMain function, or equivalent thereof, as provided by the Microsoft 
Win32 Interface, and the init function as defined in the KornSheU development kit. 
Various other implementations of shared libraries on UNIX support such 
initialization functions. 

[0222] Function Call and System Call 
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[0223] For purposes of this disclosure, a function call and a system call are often 
collectively referred to as a function call. When a particular distinction is 
necessary, the term system call will be used. 

[0224] It must be noted that the AST ToolKit, provided by AT&T Research, and 
described in Practical Reusable UNIX Software, John Wiley and Sons, ISBN 0-471- 
05807-6, includes numerous replacement functions via replacement libraries, 
related to file system access. The replacement functions currently offered by the n- 
Dimensional File System component of the AST TooUdt and the KornShell, do not 
augment these standard functions and system calls with access and interactions to 
services nor to directory service. 

[0225] In various embodiments of this invention, a function of a process can be 
augmented by providing a replacement library containing a replacement function, 
and using dynamic loading techniques to dynamically load the replacement library 
(or component thereof, to facihtate the methods and systems of this invention. 
Alternatively, the corresponding application program could be linked with a library 
providing functions offering equivalent capability of the replacement function. 
When reading the term "replacement function" or "augmented function", it is 
understood as a function providing an augmented capability or feature which is 
provided by a replacement function, or a function that the corresponding application 
program was linked with. Note that this may be in addition to the standard 
functionality of the corresponding function. 

[0226] By way of example, the recv function is firequently used in network 
programming. (See UNIX Network Programming Volume 1 Second Edition, W. 
Richard Stevens, Addison Wesley, ISBN 0-13-490012-X.). An embodiment can 
augment the functionality of the recv function to access and interact with a 
directory service in order to facilitate administrative functionality such as 
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replication, consistency, communication forwarding, and other services such as wire 
tapping, broadcasting and the Hke. Similarly, the functionality could include 
routing a received request to a second service. Thus, when the process makes the 
function call, the augmented version of the function can be used to augment or 
replace the standard functionality of the function. 

[0227] By way of example, an augmented function can access and interact with a 
directory service to determine a service providing the underlying desired 
functionality. An embodiment could interact with a directory service to determine 
where the underljdng functionality should be executed. A process issmng a write 
function, for example, could use the replacement write function which would access 
and interact with the directory service to determine how to access and interact with 
a write service providing means to write to an accessible device. Similarly, a 
process issuing a read function call, could use the replacement read function which 
would access and interact with the directory service to determine how to access and 
interact with a read service providing means to read from an accessible device. It is 
understood that such embodiments may require parameter passing from the process 
issuing the function call, to the service providing the underlying functionality. In 
such cases, the input tjrpes, and possibly the output types may also be 
communicated between the process and the service. An implementation could use 
SOAP/XML for such parameter passing, and possibly for one or more input types, as 
well as one or more output types. In this manner, a process compiled for a first 
operating system can be executed on the first operating system, but have one or 
more augmented function caUs accessing and interacting with a service executing 
on a second computer of the network having a second operating system which may, 
or may not be different from the first operating system. Note that the service may 
be a process having means to perform the desired functionality and maintain state. 
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[0228] A first process can issue an open system call and have a fQe descriptor (or 
handle) associated with the opened fQe, but the fQe may physically reside on the 
second computer of the network. 

[0229] By way of example, a code fragment written in the C language could include 
[0230] int fd=openC7etc/profile",03DONLY); 

[0231] One skilled in the state of the art would understand that open is a system 
call and the functionality of the open system call is to open a file identified by the 
first parameter, which in this case is a file named /etc/profile, for read only. Upon 
success, the open system call returns a file descriptor value to the process and the 
file descriptor value is saved in the memory location given by the integer variable 
field. (For detaQed information on the C programming language, see "The C 
Programming Language, Brian Kernighan and Dennis Ritchie, Prentice Hall 
Software Series, ISB 0-13-110362-8.) 

[0232] When augmenting the open system call, the augmented open function can 
access and interact with a directory service and specify criteria for selecting a 
service. By way of example, the criteria coiQd be a service having access to the 
/etc/profile file. If such a service is found, then the process can access and interact 
with the service to cause the service to perform the open system call. The service 
would have access to the file descriptor associated with the opened file. The service 
would remain executing, and would provide a response to the requesting process 
wherein the response indicates a value for the opened file descriptor. The response 
may be a value indicative of the maximum number of open file descriptors allowed 
by the operating system, plus the number of opened files that are opened by the 
service at the request of the process. 

[0233] The process can then issue a read function call, and specify the value for the 
opened file descriptor. The augmented read function would examine the value of 
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the opened file descriptor, and realize it is a value higher than maximum number of 
opened file descriptors supported by the underlying operating system. In this case, 
the replacement read function would deduct the maximum number of allowed 
opened file descriptors firom the specified value for the opened file descriptor, and 
would access and interact with the service providing the underlying read 
functionality. In this sense, the replacement read function would provide the 
service with the appropriate fQe descriptor value, and possible other parameters, 
and the service would then perform the read system call, and provide the results 
thereof to the process. 

[0234] The communication between the process and the service can be implemented 
using XML, or using other techniques such as messaging according to a format and 
possibly a protocol determined by the implementation. In one embodiment, the 
Safe-Fast-IO (sfio) interfaces are used (See Information Disclosure "Practical 
Reusable UNIX Software" for details on sfio). 

[0235] The process may cause one or more standard functions to be executed on the 
same computer that the process is executing on. By way of example, certain 
environment settings and user administration may need to occur on the same 
computer as the first process, while other functions can be performed on a second 
computer according to this invention. 

[0236] The process may also require a graphical user interface on the same 
computer that the process is executing on. In such cases, the functions calls related 
to the graphical user interface should not be processed by a service executing on a 
remote computer system. 

[0237] The requesting process can register certain function calls that should be 
executed on the same computer as the requesting process. The augmented function 
would then determine if the underlsdng functionality is to be executed on the same 
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computer, or shoidd be executed by the service. To make such determination, the 
augmented function may access and interact with a directory service having the 
registered certain functional calls described above. 

[0238] Certain functions return a pointer to a memory location. In such cases, an 
augmented function would access and interact with the service and the service 
would communicate the results thereof to the process. The communication can 
include representing data as characters, such as a hexadecimal character or 
equivalent (such as %32) and the data can be assembled into an allocated memory 
location accessible to the process. (See communication for details on 
communication) . 

[0239] The mapping of one or more return values and side effects of a function 
performed by a service can be determined by the implementation without changing 
the scope of the invention. Thus, a service executing a component of software on 
behalf of a process, can maintain state information about the results of the 
execution of the component of software, and, can communicate the results and side 
effects to the process, which are then assembled and made available to the process 
as if the function caU were completed on the same computer and operating system 
of the process. 

[0240] An embodiment can register additional information components about the 
devices, services, software, operating system, functionality, communication 
capabihty, characteristic and attributes thereof, and other information components 
as would be necessary to facilitate the invention. By way of example, this can 
include registration of the service having capability as disclosed herein. Such 
information may be necessary for the criteria as provided by the process. 

[0241] When using name-value pairs, or other identifiers quaUfying that portion of a 
request string which represent a service, the augmented function can use the 
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directory service to discovery the corresponding component of software providing 
the service. For example, the open function caU takes as a parameter, the name of 
the file to open. However, by providing criteria for accessing the file, the open 
function call can determine the service it should provide, by interacting with a 
directory service. By way of example, criteria specified as description="Corporate 
information about GTL" can be provided to the open function call as the parameter. 
When the open function calls attempts to open a file with that name, the open will 
fail. Instead of returning an error condition, the open function caU could interact 
with a directory service to see if there is a service that can satisfy the request. The 
directory service could either return back entry information and the open function 
could then access and interact with the service, or, the directory service can connect 
to the service satisfying the request. Thereafter, when a read function is called, the 
read function could receive information from the service and provide same to the 
process. Similarly, when a write function is called, the write function can send the 
data to the service. Finally, when the close function is called, the close function can 
disconnect from the service, 

[0242] Operating systems typically are deployed with various supporting commands 
and utihties. By way of example, this often includes a shell, such as ksh. The shell 
interprets requests and performs desired actions. The POSIX standards define 
various shell commands and utilities which can be invoked by the shell, 

[0243] On a Unix system, such as a Solaris 2.8 operating system, a frequent task is 
to invoke a cat command to display the content of a file. The cat command takes 
one or more command line arguments which are file names to display. The output 
of the cat command is displayed on standard output. Using the shell, one could cat 
the contents of a file and pipe the standard output as the standard input for a 
second command. 

[0244] The cat command is invoked as a process and the process uses the open 
function call to open the file. By augmented the open function call with criteria, we 
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can cat the contents provided as a service, as if the content where in a file on the 
local computer. Thus, the cat command itself does not need to be recompiled to take 
advantage of this capability. Instead, we use the augmented open function from a 
dynamically loadable library. 

[0245] Similar behavior can be achieved for aU standard UNIX commands and 
utilities that are dynamically linked. 

[0246] Similar behavior can be achieved for all standard command and utiHties of 
the UAVIN product line, as well as other applications that are dynamically Unked. 
The UAVIN product line provides the KornShell and the shell commands and 
utihties for the Windows operating system. 

[0247] Registration: 

[0248] The registration can be an automated process such that whenever a service 
begins executing, it always registers its availability with the common directory 
service. Alternatively, the service can be accessible through a well-defined 
connection such as a URI, or on a dedicated Internet Address and port. In such 
cases, the registration process may occur once. In other implementations, a process 
having appropriate information about the service can register the service. In other 
implementations, the service may be registered via a user interacting with a 
graphic rendering program providing a form for the user to complete and submit 
electronically. StiU, in other implementations, the registration process may be via 
computer mail. The registration process can also be implemented with SOAP/XML 
techniques. The registration process coidd also be implemented through remote 
procedure call, or equivalent thereof. Once skilled in the state of the art would 
understand that there are a multiphcity of methods for performing the registration 
process, even calling a person who could manually enter the registration 
information as required. 
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[0249] The registration process can include an identifier identifying the directory in 
which the registration is to occur. By way of example, a registration may indicate' 
sd="Public Services" in which case the registration is to occur in the Public Services 
service directory. A default directory can be used when the registration process 
does not provide such a service directory identifier. 

[0250] The registration information includes information provided by the process (or 
processes) participating in the registration. The registration information is said to 
contain one or more information components. An implementation can use a name- 
value pair for an information component, such as name="Charles Northrup", or, can 
use XML to communicate the information component, or various other techniques 
which may, or may not require a schema. 

[0251] The implementation can support private and public attributes, as described 
in US Patent 5,850,518. In such cases, an information component can be marked as 
private, and thus would be accessible only to the directory service, but would not be 
returned in queries or reports. A private information component is always 
accessible to the administrator of the directory service. Similarly, a private 
information component is always accessible to the owner of the service. 

[0252] An information component can be marked with a Group attribute. According, 
members of the specified group (or processes acting on their behalf would have 
access to the information component. 

[0253] Implementations can use underl3dng operating system security semantics as 
well. For example, a Unix system supports the notion of read/write/execute 
permissions for owner, group, and others. Such operating system semantics can be 
used. 
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[0254] The registration process can include the use of a graphical interface to make 
the registration experience more pleasurable for the user. Such implementations 
could be facilitated through the use of the Microsoft Internet Explorer or equivalent 
thereof. Alternatively, the graphical interface can be provided by other means, as 
one skilled in the state of the art would understand. 

[0255] Note that some implementations will have the directory service provide 
required registration information to the registering process, and that such 
information may be communicated to a user of a computer system, and that the 
user would provide the required information and the required information would 
then be accessible to the directory service. 

[0256] The registration information is administered by the directory service, which 
can use a registry to provide persistence for the data. 

[0257] A service provider can register a multiplicity of registrations with the 
common directory service. This can permit artificial intelligence methods for the 
selection of the service satisfying criteria. The selection can include events, time 
specifications, access methods, communication methods, methods providing 
selection based on response times, and the like. In such cases, a service provider 
can register that the service provided by the service provider at a particular 
network endpoint is accessible only during certain hours of operations, which may 
include day of week, month, year, etc. The same service can be registered for a 
different network endpoint for a different hour of operations, which may include day 
of week, month, year, etc. The only restriction is that duplicate entries in a single 
service directory are not supported. 

[0258] It is noted that repHcation of entries between service directories registries 
may be provided by the implementation. In such cases, a first directory service can 
provide a second directory service with one or more registration entries maintained 
by the first directory service, in order to replicate the data maintained in the 
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registry. An implementation can use the methods of US Patent 5,572,709, or 
eqxiivalent thereof. Each time an entry is written to the registry, the write(2) 
system call can be augmented to duplicate the write request to a remote file store. 
The write(2) system call can also use the directory service to determine a remote 
process having capability to receive registry updates. The write(2) system call can 
connect to the remote process and communicate the information related to the write 
system call. The remote process would receive the communication and perform 
equivalent action to a data store maintained by the remote process. The remote 
process can either update its registry immediately, or, store the communication 
until sufficient communications have been received, and use bulk data loading 
techniques to bulk load the data. 

[0259] In a second implementation, a first directory service receives requests, and 
depending on the request received, will duplicate the request to a second directory 
service. By way of example, the first directory service receives a request. The 
request is scanned to determine if the request is to register a new service, and if so, 
the first directory service accesses and interacts with a remote directory service to 
replicate the request. This would be in addition to the first directory service 
performing the operations of the received request. 

[0260] To maintain consistency, other request such as delete, modify, change, 
update, and others can also be replicated. 

[0261] The implementation can provide this capability in a function of a 
dynamically-linkable replacement library. One example of a dynamically-linkable 
replacement library is found in US Patent 5,572,709. 

[0262] By way of example, a gethostbyname standard operating system interface 
call can be augmented to access and interact with a directory service as reqvdred. 
(See UNIX Network Programming Networking APIs, UNIX Network Programming 
series. Second Edition, by W. Richard Stevens, pp 240-246, ISBN 0-13-490012-X for 
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details on the standard gethostbyname operating system interface.) Program 
Listing 1.1 provides a source code listing of one implementation for the replacement 
gethostbyname function which is then compiled into object code, and archived in a 
replacement shared library with the same filename as the standard shared library 
containing the operating system provided gethostbyname function. Using the 
LD_LIBRARY_PATH environment variable setting to first point to the location of 
the replacement shared library; the replacement gethostbyname function would be 
used whenever a process invokes the gethostbyname function. 
[0263] The standard system version of the gethostbyname function accepts a single 
parameter hostname, which is a pointer to a character string and returns a pointer 
to a hostent structure on success, or a NULL pointer on failure (Program Listing 1.1 
line 3). 

[0264] In this embodiment, the gethostbyname function will first invoke the system 
version of the gethostbyname function (Program Listing 1.1 line 8) to see if it is able 
to resolve the host name reference given by the value pointed to by parameter 
hostname. 

[0265] If the system version of the gethostbyname function is not able to resolve the 
hostname, then the gethostbyname function will consider the host name reference 
given by the value pointed to by parameter hostname as criteria for selecting a 
service. In this case the gethostbyname function wiU query the directory service 
(Program Listing 1.1 line 12) and will examine the results of that function to see if 
connectivity has been registered for a service satisfying the criteria (Program 
Listing 1.1 lines 13-18). In this case, the gethostbyname function wiU then invoke 
the system version of the gethostbyname function (Program Listing 1.1 line 19). 

[0266] In a second embodiment, the standard operating system interface call can 
include the necessary computer instructions to access and interact with the 
directory service. 
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[0267] Other embodiments are possible. By way of example, the gethostbyaddr, 
gethostbyname2, getservbyname, getservbyport, getnameinfo, and others, can have 
appropriate replacement functions to access and interact with the directory service. 
This is not limited to socket application programming interfaces. By way of 
example, an open system call can be modified to access and interact with a service, 
through the use of a directory service. 

[0268] The benefit of using replacement dynamically loadable Ubraries is that the 
original source code for the application program need not be modified to gain the 
advantage of working with the directory service. Thus, applications, such as telnet, 
Netscape communicator, ftp, ping, and others, can immediately take advantage of 
the directory service, without having to recompile the appUcation. 

[0269] By using a replacement dynamic link library with an alternative 
gethostbyname function, the user can enter information that can then be 
communicated to a directory service, and the appropriate response displayed. 

[0270] In an enterprise network, such as within the Global Technologies Ltd., Inc., 
domain (gthnc.com), we can maintain a registry containing contact information for 
our employees. When using the browser, a first employee can enter "contact 
information for Charles Northrup" and the directory service locates a service 
providing that information, accesses and interacts with the service, and 
communicates the response firom the service, to the browser process. 

[0271] Netscape 4.73 and Microsoft Internet Explorer version 5.0 permit the user to 
enter a string. Both products attempt to resolve the entry by using a domain name 
lookup service, usually provided by gethostbyname (or equivalent thereof. When a 
domain name cannot be determined, both products will interact with web search 
engines to determine a relevant page. By way of example, the Microsoft Internet 
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Explorer will communicate with the Microsoft Service Network search engine site. 
If the string was entered as C'\ then both products insert a fQe schema and as 
translate the request as file-///C I /. Neither product permits access and interaction 
with a directory service. 

[0272] The implementation can also be provided directly by the operating system 
interfaces themselves. 

[0273] An example directory service is shown in Program Listings 4.1 through 4.7. 
The embodiment provides for a register command, a create command, a query 
command, and a delete command. When registration is to occur, the name/value 
pair may include a ".private" notation to indicate that the name/value pair is 
private, and shoidd not be reported as part of a query command. As an example : 

[0274]Name="charles northrup" phone.private=609-924-7305 

[0275] In this context, the registration entry will include two information 
components. The first is a name component, having value "charles northrup" and 
the second is a phone component having value 609-924-7305. When querying the 
directory service using- 

[0276] Command-query name="charles northrup" 

[0277] then the query will report the name component and its value, but not report 
the phone component nor its value. 

[0278] An implementation can add a ".mandatory" attribute to an information 
component to force the specified information component to be included in a query 
request. By way of example, 

[0279] Command=register name="charle8 northrup" phone.mandatory=609-924"7305 
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[0280] In this example, a query request must include phone=609-924-7305 in order 
for the entry to be included in the query resvdts. 

[0281] An implementation can add a ".group" attribute to an information component 
such that the a group list is maintained by the directory service, and only those 
belonging to the group can see the residts of the query. By way of example- 

[0282] Coinmand=reg:iBter name="charle8 northrup** group.inandatory=officer 

[0283] In this example, a query request with criteria name="charles northrup" 
would require the request process to supply additional information so that the 
directory service can determine if the request is on behalf of a member of the 
specified group. 

[0284] Note that the use of the attributes can be extended to a connect request 
facilitated by the directory service. In such cases, a request of 

[0285] Command=connect name="charles northrup" 

[0286] Would be subject to the same constraints as the query command, as described 
above. 

[0287] In assigning attributes to information components within a registry entry, an 
implementation can use the directory service itself to access and interact with a 
service providing the desired functionaUty. By way of example, the private 
attribute described above can be a registered service within the common directory 
service (CDS). When the CDS receives a query command, and locates one or more 
entries satisfying the request, the CDS could access and interact with a "private" 
service which could perform translation to an empty string for that information 
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component. In a another implementation, an information component can have a 
"normalize_to_upper" attribute and the CDS would access and interact with the 
service providing normalize_to_upper normalization of the data content for the 
value portion of the name / value information component. 

[0288] Registration Information 

[0289] By way of example, but not limitation, this may include one or more of 

- consumer information 

• name 

• street address 

■ city 

• state 

- country 

- postal code 

- information representative of the consumer computer 

• information representative of the operating system of the consumer 
computer 

- information representative of the communication devices of the 
consumer computer 

■ information representative of components of software accessible to the 
consumer computer 

• consumer contact information such- 

- telephone number 

- fax number 

- beeper number 

■ pager number 

- wireless access number 

- cellular phone number 

- company information 
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• afGliation information 
corporation information 
non-profit business information 

- organization information 

- agency information 

• consumer add-on services 

- consumer subscribed services 

- consumer billing information 

- consumer payment information 

- consumer historical usage information 

- consumer historical payment information 

• consumer transaction information 
consumer security information 

- consumer profile information 

- consumer access information 

- consumer geographical information 
consumer preference information 

■ consumer enhancement service information 

- payment type 

- payment provider unique id 

- payment account unique id 

- payment billing information 

- payment billing name 

- payment authorization unique id 

- payment provider id assigned expiration date 

- payment provider code 

• payment bank unique id 

- payment bank authorization unique 
connectivity required to reach a service 

■ access point 
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■ Internet address 

■ port 

■ protocol 

■ network type 

- data representation 

- service availability time 

- duration of service 

- owner information 

- group information 

[0290] When used in conjunction with the methods of US Patent 5,850,518, the 
information can include one or more of the information components as defined in 
the thread directory service. By way of example, but not limitation, this can include 
the physical connectivity required to reach the consumer, the consumer service, or 
any seirvice including a minor service, a communication primitive to be used in 
communications wherein the information on the physical connectivity required is 
used by the communication primitive to estabUsh connectivity. As an example, a 
consumer computing device connects to the Internet through an Internet Service 
Provider [ISP] and is assigned a dynamic Internet Address. The registration 
information can include the dynamic Internet address and possibly one a port for 
sending and receiving communications. One skilled in the state of the art would 
understand that a mxiltiphcity of ports may be used in facilitating the 
communication. 

[0291] Alternatively, if the consumer computing device has a static Internet Address 
associated with it, that the static Internet Address and a designated port can be 
registered. One skilled in the state of the art would understand that a network 
address and possibly a port number, or equivalent thereof, can be used. By way of 
example, an Internet Address may be 192.127.0.3 and a port may be 3999. 
Alternatively, an Internet Address can be workhorse.gtlinc.com and a binding 
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service such as that provided by the name daemon or equivalent thereof would bind 
workhorse.gtlinc.com to an appropriate network address. 

[0292] Accesses and Interacts 

[0293] The phrase accesses and interacts implies the use of a multiplicity of 
processes. The processes may communicate via interprocess communications, 
intraprocess communication, or through a communication device as supported by 
the underlying operating system. Communications can be instrumented through 
protocols. A first process can be executing on a first computer of the network, and a 
second process executing on a second computer of the network. It is understood 
that this may include one or more intermediary processes to facilitate the 
communication, as determined by the protocol. It is understood this may include 
one or more intermediary processes to facilitate the communication, as determined 
by the network. The network can be the Internet, a private network, a public 
network, or some other network such as the virtual network as described in US 
Patent 5,850,518. 

[0294] The phrase access(es) and interacts can also imply loading a dynamically 
loadable module into the address space of the first process and invoking a function 
entry point in the dynamically loadable module either directory, or indirectly 
through an initiahzation function supported by the underlying implementation. By 
way of example, the DllMain function is invoked whenever a dynamicaDy Hnked 
library is attached to a process. 

[0295] Criteria 

[0296] Criteria can be implemented through name/value pairs, which may include 
using regular expressions and possibly even using Boolean operators, through SQL 
statements, through OBDC instructions, JDBC instructions, Microsoft ADO.NET, 
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through Daytona Cymbal statements, and other implementations. The 
interpretation of the specification of the criteria is implementation dependent. 
Various protocols can also be used. A natural language system could be used in 
conjunction with the directory service, to interpret the criteria. Examples of 
Natural Language Systems include CHAT, firom Network Services and Interfaces 
Laboratory, Communications Research Centre, 3701 Carling Ave. Ottawa, ON 
CANADA K2H 8S2. Additional technical papers include A Form-Based Natural 
Language Front End to a CIM Database, Nabil R. Adam, Aryya Gangopadhyay, 
March-April 1997 (Vol. 9, No. 2), Knowledge and Data Engineering, IEEE (also 
available at http://www.computer.org/tkde/tkl997/k0238abs.htm). 

[0297]Preprocess 

[0298] The term preprocess, as used in this specification, indicates a service that is 
to be performed on a commxmication prior to primary processing. By way of 
example, this may result in a second memory location being made available to the 
process wherein the second memory location has the results of the preprocessing. 
By way of example, the preprocess service may: 
translate a communication 

interact with a service to alter the communication such as macro 

expansion, or regular expression evaluation 

decrypt the communication 

unscramble the communication 
- access and interact with a directory service to ascertain information 

relevant to the communication 
■ convert a component of the communication fi'om a first format to a 

second format, such as converting a string to a hexadecimal number, 

an integer, a binary value, ..etc 

convert a component of the communication firom a first arbitrary 
named representation to a second arbitrary named representation 
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- normalize a component of the communication, such as in changing the 
case, the format, or the data representation. 

[0299] The preprocess service may be dynamically loadable. The implementation 
may determine which preprocess service to dynamically load. Such determination 
could be made by accessing and interacting with a directory service, and possibly by 
using a component of the communication. 

[0300] By way of example, a first process receives a communication and examines 
the communication for a name/value pair. The first process uses the name/value 
pair as criteria for selecting a preprocess service. The first process accesses and 
interacts with the preprocess service. 

[0301] A communication received by the first process can be encrypted according to a 
first encryption method. The first process would then access and interact with a 
service providing decrjrption of the communication according to the first encryption 
method. The same first process can receive a second communication encrypted 
according to a second encryption method. The first process would then access and 
interact with a service providing decrjrption of the communication according to the 
second encryption method. By selectively accessing and interacting with the 
preprocess service, additional encryption / decryption methods can be devised in the 
future and the first process wlQ be able to take advantage of same without having to 
recompile the first process. 

[0302] A communication received by the first process can be formatted according to a 
first protocol. The first process can access and interact with a service providing 
translation of the communication from the first protocol to a second protocol. The 
first process would then process the communication according to the second 
protocol. 
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[0303] A communication received by the first process can be formatted according to a 
first language. The first process can access and interact with a service providing 
translation of the communication from the first language to a second language. The 
first process would then process the communication according to the second 
language definition. 

[0304] A communication received by the first process includes a mixture of upper 
case and lower case characters. The first process can access and interact with a 
normalization service providing means to convert one or more of the lower case 
characters to upper case, or upper case to lower case as determined by the 
implementation. By way of example, the URL 

http7/w WW. gtlinc.com/research/research.html, can have a portion of the URL 
normalized, while the remainder of the URL remains as received. One 
implementation can convert http7/www.gtlinc.com, firom lower case to upper case, 
while a second implementation may convert from upper case to lower case. When 
the communication includes a component which is relative to a well known root, 
then the normalization may convert the relative portion to a fully expanded name 
which includes the root. By way of example, a relative URL given as 
research/research.html, may be normalized to the fully qualified name of 
httpV/www.gtlinc.com/research/research.html. 

[0305] Note that it is possible for a NULL preprocess service to be indicated to the 
first process, in which case, the first process would not call the preprocess function. 

[0306] Note that a preprocess service may allocate and initialize even in part, a 
memory location to be used by the first process. 

[0307]Postprocess 
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[0308] A first process may access and interact with a post processing service. In the 
case of a software engine, the postprocess service performs deallocation and garbage 
collection of memory allocated, frequently by the preprocess service. Postprocessing 
can also include translation, formatting, normalization, and even encryption of a 
response, prior to sending the response. 

[0309] Common Directory Service 

[0310] The phrase common directory service implies a directory service accessible to 
a requesting process (or a service), and, containing information related to a desired 
service. A component of software can be used on a first computer of the network to 
communicate with the directory service executing on a second computer of the 
network. An implementation can use a multipUcity of directory services, and, that a 
directory service may access and interact with additional directory services, as 
necessary. A process may also be configured to have direct access to the directory 
service as a function of the process. In such cases, the process invokes a function 
providing the administrative feature desired (i.e., registration, query, unregister, 
modify, update, create, join, select, ..etc). 

[031l]Facihtates the Connection On Behalf of the Requesting Process 

[0312] The phrase facilitates the connection on behalf of the requesting process 
impHes the directory service connects the requesting process to the desired service. 
One skilled in the state of the art would understand that an implementation of the 
directory service could provide the required connectivity to reach the service, to the 
requesting process, and the requesting process could connect to the service. One 
skilled in the state of the art would also understand that an implementation of the 
directory service could include the Thread Communication Service as disclosed in 
US Patent 5,850,518. One skilled in the state of the art would also understand that 
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there are variations of the implementation within the scope of the invention that 
can be used to facilitate the connection. 

DETAILED DESCRIPTION 

[0313] A service is executing on a computer system on a network. The service can be 
listening on a network endpoint, such as an Internet address and port. The 
implementation can use the socket application programming interface, or some 
other method as provided by the underlying operating system interfaces for 
communication connectivity and synchronization. For the service to be used by a 
requesting process, the service must first be registered (see registration) with a 
common directory service. 

[0314] The requesting process begins execution, and accesses and interacts with a 
common directory service. The requesting process specifies criteria for a desired 
service. 

[03 15] The common directory service locates a service entry satisfying the criteria, 
and facilitates the connection on behalf of the requesting process to the desired 
service. 

[0316] A user of the computer may be interacting with the requesting process. The 
user can cause the computer operating system to access and interact with a process 
to complete registration. 

[0317] The user can communicate a request for a service to a requesting process. In 
this context, the user is referred to as a consumer. The requesting process woidd 
then access and interact with the common directory service on behalf of the user. 
The requesting process, which may first need to preprocess the user request, can 
provide the request to the directory service. 
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[0318] The requesting process can then access and interact with the desired service. 

[0319] Since the user is a registered user, the service can access and interact with 
the common directory to determine public registration information components 
about the user. 

[0320] Similarly, the requesting process can access and interact with the common 
directory service to determine public registration information about the service. In 
certain implementations, the requesting process can access and interact with the 
common directory service to determine pubUc registration information about the 
provider of the service. The requesting process may communicate such determined 
information to the user, either through audio or graphically through the use of a 
graphical user interface, or text based as one might use the curses Hbrary available 
on UNIX derived implementations. The requesting process may access and interact 
with a component of software accessible to the requesting process to filter out 
certain services deemed inappropriate or undesirable. 

[0321] A registered consumer can also provide a service. To provide the service, the 
consumer must register the service with the common directory service. Once 
registration is complete, the service provided by the consumer will be accessible 
through the common directory service. 

[0322] A service provided by the consumer can be implemented with a callback 
capabiUty. By way of example, a consumer request a service from a service 
provider, and the consumer must pay for the service. In this context, the consumer 
supplies service provider with access to the consumer's the unique identifier. The 
service provider service accesses and interacts with the common directory service to 
request access to the consumer's payment information service. The common 
directory service locates the consumer service satisfying the request, and creates a 
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transaction identifier to indicate that a transaction is in progress. The common 
directory service can complete a registration of the pending transaction. The 
common directory service then accesses and interacts with the consumer payment 
service. It provides the pending transaction unique identifier to the consumer 
payment service, and then disconnects. The consumer payment service then 
accesses and interacts with the common service directory specifying criteria 
including the unique identifier of the pending transaction registration entry. In 
this context, the consumer payment service is now a requesting process. The 
common directory service then facilitates the connection on behalf of the requesting 
process to the service provider process awaiting payment information, as identified 
by corresponding transaction id. 

[0323] When using the invention on a computer system behind a firewall, a 
consumer providing a service may request a service provider providing a service 
hosting service, to host the consumer service on behalf of the consumer. 

[0324] When using the invention on a computer system behind a firewall, the service 
can complete registration with the common directory service indicating that request 
to access the service from the common directory service are to be facihtated through 
a protocol, such as computer mail protocol. Thus, the common directory service 
would send computer mail to the owner of the service, and a service process 
executing on the computer system would read the computer mail and determine 
that there is a request for the service. The service process would then facilitate a 
connection to the central directory service. In one embodiment, the service process 
can provide the request to the requested service and the requested service would 
then access and interact with the common directory service. In a second 
embodiment, the service process would access and interact with the common 
directory service on behalf of the requested service. It is noted that an 
implementation can use various methods for automating the registration process in 
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this regard, and defaulting to computer mail protocol when other tyj^es of 
connectivity cannot be established. 

[0325] When accessing and interacting with a service, a requesting process can 
communicate according to a first protocol, which is then brokered by the common 
directory service to a second protocol as required by the service. Alternatively, a 
service process can communicate according to a first protocol, which is then 
brokered by the common directory service to a second protocol as required by the 
requesting process. In such cases, this may include the use of language 
translations. By way of example, a first language can be formatted according to the 
rules of a second language. The broker service can use a translation service to 
perform such translations according to weU-defined rules. The translation service 
may also use templates as required. 

[0326] Various embodiments of using services, communication flow between 
services, registration of services, ordering of registration, ordering of callbacks, are 
presented. Once skilled in the state of the art would understand that various 
permutations are permitted by the invention. Thus, a callback in one service could 
easily be implemented in a second service, as appropriate. 

[0327] Additional Services 

[0328] Numerous additional services can be added to the consumer service, the 
provider service, or the central service. Such additional services are contemplative 
of means to facilitate the transaction, and to ease the burden of administering the 
data associated with the transaction. Examples of such services are^ 

a component of software accessible to the consumer computer which 
activates upon notification of pending transaction, to alert the 
consumer that a transaction is now in progress. The alert may be 
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audio or visual, or combination thereof. By way of example, the 
component of software may cause an icon to become visible while the 
transaction is in progress. 

- a component of software accessible to the consumer computer that 
activates upon notification of pending transaction and requires the 
consumer to select an "Authorize Payment Information Transfer" 
option. If the consumer does not select the option within a predefined 
period of time, then the transaction would abort. Alternatively, a 
"Decline Payment Information Transfer" option may be selected by the 
consumer, and the transaction would abort. By way of example, the 
component of software may display such options as graphical 
representations for the user to select via depressing a mouse button 
(i.e., "chck"). 

■ a component of software accessible to the consumer computer to permit 
the consumer to select a current payment option from a plurality of 
payments options available to the consumer. By way of example, a 
consumer has a mxiltiplicity of credit cards and maintains payment 
information for each such credit card. When notified of a pending 
transaction, the consumer can select which of the registered credit 
cards is to be used. 

- a component of software accessible to the consumer computer to permit 
the consumer to select a current payment option from a plurality of 
payment options communicated by the service provider to the central 
service, and from the central service to the consumer service. By way 
of example, a service provider may accept only American Express 
credit cards. By communicating this to the central service, and from 
the central service to the consumer service, then the consumer service 
can alert the consumer that American Express is the only credit card 
accepted by the service provider. Accordingly, the consumer service 
can automatically select the American Express registered information 
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and communicate such information back to the central service [and 
from the central service to the service provider], 
a component of software accessible to the consumer computer to 
temporarily deactivate, or to terminate, the consumer service providing 
the payment information. By way of example, the consumer can use a 
mouse connected to the computing device to select an icon, such as a 
wallet, or a purse, to indicate that it is to be closed. In closing the 
wallet, the consumer service providing the payment information woidd 
then be deactivated or terminated. Similarly, selecting the same icon 
[or a different icon which graphically conveys the notion that the 
wallet is closed], can cause the consumer service to reactive. In such 
instances one can use a first icon to indicate the consumer service is 
not executing, and a second icon to indicate the consumer service is 
executing. 

■ a component of software accessible to the consumer, providing means 
to communicate with the central service. This provides means interact 
with the central service to facilitate transaction reports, to inquiry on 
service providers having registry entries containing the consumer the 
unique identifier, to change keywords recorded in the registry for the 
consumer for a specified service provider, or, for facilitating 
administrative functionality as one would anticipate for a consumer / 
service provider relationship. 

- a component of software accessible to the central service to alert 
consumer of transaction in progress. This may include changing an 
icon from a first color to a second color to indicate the transaction in 
progress, and back to the first color once the transaction is complete. 
Alternatively, the component of software can display one of two 
different icons to indicate the current state as either in progress, or, 
transaction complete. 
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- a component of software accessible to the central service to periodically 
verify the consumer through interaction with the consumer service. 

a component of software accessible to the central used by the central to 
track frequency of use based on statistical analysis to alert for possible 
ftaud. 

• the service provider can communicate pajnnent options to the central. 
The central can send the information to the consumer service. The 
consumer service can alert the consumer to the available payment 
options, and the consumer can select a particular option for that 
transaction. 

■ the service provider can communicate total payment required to the 
central. The central can send the information to the consumer service. 
The consumer service can alert the user and possibly request 
authorization based on the total amount of the payment. 

- the service provider can communicate transaction details to the 
central, which then communicates the information to the consxuner 
service, providing the means for the consumer service to detail the 
information on the consumer computer. 

■ a component of software accessible to the service provider process 
which communicates with the central service, to provide certain 
consumer registry information to the service provider. In this context, 
a field marked as PUBLIC, can be returned to the service provider. 
Thus, a consumer can supply the service provider with the consumer's 
the unique identifier, and the service provider can contact the central 
service, communicate the consumer's the unique identifier, and receive 
a communication from the central service representative of the 
consumer's registered information that is publicly available through 
the registry implementation. 

[0329] Software Engine Service 
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[0330] A service can be instrumented through a software engine. The software 
engine uses a specification describing one or more components of the engine. The 
specification is referred to as the engine configuration specification. The 
components of the engine are referred to as the component services. Note that a 
component service provides a service, and hence the component service is often 
referred to, more simply, as service. An example of an engine configuration is 
provided in Program Listing 2.16. 

[0331] A minimal engine specification contains sufficient information for the 
software engine to associate the component identified in the specification with a 
service, which may be provided by a component of software. As such, the engine can 
access and interact with the service as necessary to perform the desired action. 
[0332] As an example, a specification can identify a given service that is to be 
dynamically loaded through the use of one or more operating system interfaces. 

[0333] It is expressly understood that the specification of the engine components can 
be facilitated through a schema. In use with the Daytona Data Management 
System, a record class provides equivalence of a schema. 

[0334] Similarly, a specification can be facilitated through the use of one or more 
data structures. 

[0335] Similarly, a specification can be fadhtated through the use of one or more 
name spaces. A name space may be facilitated by the operating system, an 
application having means to interpret a name space, a middleware layer having 
means to interpret the name space, an interpretive language processor having 
means to interpret the name space, or through the use of a directory service such as 
LDAP, Microsoft Active Directory, or the Thread Directory Service of US Patent 
5,850,518. By way of example, but not limitation, a name space could be given as- 
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[0336]engine= 
[0337] ( 

[0338] component=authenticate 
[0339] ( 

[0340] name=auth; 

[034l] location=libservices.so.l.O; 

[0342]) 

[0343] coinponent=input 
[0344] ( 

[0345] name=readline; 

[0346] location^libservices.so. l.O; 

[0347]physical=127.0.0.l:9998 

[0348]) 

[0349]) 

[0350] A similar specification could have been given as^ 

[035 1] engine=test_engine 

engine.authenticate.name=auth)* 
engine.authenticate.location=libservices.80. l.O; 
engine.input.name=readline 
engine.input.primitive=inet 

- engine.input.physical=127.0.0.i:9998 

[0352] Various methods for providing the specification coxild be implemented 
through various name space techniques. Such techniques could include the use of 
SOAP/XML, XML, or other protocol and, or language specifications. 

[0353] By way of example, but not limitation, the engine could be designed to- 
communicate with a service to discover the specification, or 

- communicate with a service that sends the specification to the engine, 
or 

- access and interact with an accessible file to determine the 
specification, or 
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• access and interact with environment settings to determine the 
specification, or 

- access and interact with operating system interfaces to determine the 
specification., or 

- access and interact with a service to discover the specification, or 

- use one or more of the above to determine the specification. 

[0354] When an engine must determine the data type of a specification component, 
the engine could access and interact with a service providing such information. By 
way of example, but not limitation, ODBC, JDBC, backtalk, XML schemas, and 
other such methods can be used. One skiQed in the state of the art should interpret 
this to imply that the engine can interact with a service providing the detailed 
information on one or more components of the specification in order to determine 
the data type. 

[0355] Alternatively, the engine can use a binding service such as that provided for 
in US Patent 5,850.518 to determine the association of an identifier with an entity 
understood by the binding service. By way of example, but not limitation, the 
binding service can use a method providing means to associate the identifier to a 
data type. The engine can then request information from the binding service to 
receive the data type information. In such cases, the binding service method can 
use a service such as ODBC, JDBC, backtalk, XML schemas, or other such methods 
as appropriate. 

[0356] An engine can be implemented with a services of components preconfigured, 
but dynamically loaded as specified by the specification. By way of example, a 
standard engine could provide- 

■ authenticate ■ a service for determining if the requesting process is 
authorized to use the service 

- input " a service providing means to receive input 
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- preprocess - a service providing preprocessing of the input 

- process ■ a service providing primary processing 

- postprocess ■ a service providing postprocessing of a response 
■ response " a service providing a response 

[0357] The standard engine can also access and interact with one or more of a 
startup service, a shutdown, and an engine configuration service. 

[0358] A specification for the standard engine may include- 

[0359] Component=authenticate naine=auth location=libauthenticate.so.l.O 

[0360] This would instruct the engine to dynamically load the authenticate service 
given in the dynamically loadable library called libauthenticate.so.1.0, and module 
name auth. 

[0361] When configiired with a directory service, the above specification could be 
given as- 

[0362] Component=authenticate name=auth 

[0363] This would instruct the engine to use a directory service to locate the service 
named auth, and to access and interact with the service accordingly. 

[0364] A specification for a standard engine may include a placeholder service for a 
component. In this case, the engine will access and interact with the placeholder 
service even though the placeholder service contains a simple return statement or 
exit statement and performs no other action. 

[0365] An authentication service can be implemented to determine if the process 
accessing and interacting with the service, is permitted access to the full capability 
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of the engine. For example, an authentication configuration file can store 
information indicating a host, and indicating if the service is allowed or denied 
according to the host. The authentication service can then access and interact with 
the authentication configuration file to determine is full access is granted. 

[0366] Authentication can include receiving a unique identifier assigned to an entity 
providing a service (or a registered user), and determining if the entity is permitted 
according to the rules of the authentication service. By way of example, an 
authentication configuration file can include ^ 

[0367]CID=0xl924865319279337 ho8t=gtlinc.com command=allow 

[0368]CID=0xl924865319279337 host=* command=deny 

[0369] When the authentication service is invoked, the host computer requesting the 
service must be gtlinc.com and the request must include the CID value 
0x1924865319279337. 

[0370] The authentication service configuration specification can reqviire the 
authentication service to access and interact with a directory service that a specified 
component appears in a registry entry. By way of example, a configuration 
specification of 

[037l]criteria="host=gtlinc.com cid=?" command=allow 

[0372] woidd cause the authentication service to fill in the cid value according to the 
received communication, and provide that name value pair, as well as 
host=gtlinc.com name / value pair, as criteria for the directory service to determine 
if the specified cid entry contains host=gtUnc.com. If so, the engine would continue 
processing, otherwise, the engine would deny access. Note that in this example 
configuration specification, the value of cid=? would be interpreted by the service as 
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a macro expansion to be completed by the service. In this case, the service can use a 
component of the communication, or equivalent thereof, to complete the value 
portion of the name/value pair. 

[0373] It is understood that when the authentication service must receive a 
communication containing an information component, then the authentication 
service may access and interact with an input service and possibly a preprocess 
service, before authentication can be completed. This may be necessary when the 
authentication service requires the requesting process to provide name/value pairs. 

[0374] Note that unlike the UNIX inetd process, which can use a TCP Wrappers 
implementation to determine if the request from a remote system is authenticated, 
the use of the engine is on a per engine basis. Each authentication service can have 
its own authentication configuration specification, regardless of the network 
endpoint on which the requesting process is listening on. Similarly, each 
authentication service can have its own authentication configuration required for a 
two-way handshake when a requesting process connects to a service. That is to say, 
the requesting process can use the authentication service to verify the connected 
service, just as easily as the connected service using an authentication service to 
verify the requesting process has access rights to the service. 

[0375] In the embodiment provided in Program Listing 2.0 through 2.18, the 
software engine is configured to access and interact with a startup service, if 
defined in the engine configuration. Similarly, if the engine configuration specifies 
a shutdown service, then the engine uses the atexit operating system interface to 
cause the shutdown service to be invoked when the engine terminates. The basic 
engine components are given as authorize, input, preprocess, process, postprocess, 
and response. Placeholder services are used for each of the aforementioned 
services. During initialization, the engine accesses and interacts with the 
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configuration to determine what service components are specified, and how to 
access and interact with them. 

[0376] The startup service is typically used for memory allocation of one or more 
data structures used by the components. In general terms, the startup service 
performs resource initialization. By way of example, the startup service may access 
and interact with the common directory service to determine available services, 
entities providing services, characteristics of entities or services, registration, and 
similar operations. 

[0377] The shutdown service is typically used for memory deallocation and 
performing closure routines. The shutdown service, in general terms, deallocates 
resources. By way of example, the shutdown service may access and interact with 
the common directory service to deallocate resources, deregister, or perform other 
operations. On a Windows operating system, the embodiment may use the atexit 
function, or equivalent thereof. 

[0378] Program Listing 2.17 shows a second embodiment of the software engine. In 
this embodiment, each time the engine is called, the engine will call the 
configure_engine service (function) to perform engine configuration. In this sense, 
each time the engine is to do something, it will always reread the configuration 
specification to determine the current engine components. This permits a first set 
of engine components to be provided in a first engine configuration specification, 
and a second set of engine components to be used for subsequent engine processing. 

[0379] When used with the generic fi-ont end loading service (gfeD, we can specify 
that the engine provides a service by invoking gfel with the appropriate parameters. 
By way of example • 

[0380] gfel name=engine location=Ubengine.so.l.O primitive=INET 
physical=192.168.200.15:999 
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[0381] causes gfel to start the engine listening at internet address 192.168.200.15 
port 999. When used with gfel, the engine can include an administrative service 
such that when accessing and interacting the administrative service, the engine 
component parts can be reordered, replaced, or otherwise permitting dynamic 
reconfiguration of the engine. 

[0382] Program Listing 2.18 shows a third embodiment of the software engine. In 
this embodiment, the number of engine components parts, nor their ordering, are 
predetermined by the engine. Instead, the components are determined by reading 
an engine component specification. Component ordering is maintained based on fifo 
ordering. In an alternative embodiment, a hash list, or other mechanisms known in 
the state of the art can be used. By way of example, component ordering can be 
determined by specifying the component order number in the configuration 
specification, or, by deducing component order specification based on dependency, 
or, estabUshing component ordering based on rules. The engine can determine the 
components and their ordering by processing the engine configuration specification. 
In an alternative embodiment, the engine could access and interact with a service to 
determine the engine component specification. For example, the engine could 
access and interact with a common directory service to query for information 
components containing a keyword such as keyword=engine.conf, and use the results 
of the query to configure the engine. 

[0383] Authentication Service 

[0384] An authentication service provides authentication for use of a service. A 
widely used and well known authentication mechanism is tcpwrappers. 

[0385] The following paragraphs are fi-om The Red Hat Linux 7.2: The Official Red 
Hat Linux Reference Guided 
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[0386] TCP wrappers and xinetd control access to services by hostname and IP 
addresses. In addition, these tools also include logging and utilization management 
capabilities that are easy to configure. 

[0387] Many modern network services, such as SSH, Telnet, and FTP, make use of 
TCP wrappers, a program that is designed to stand between an incoming request 
and the requested service. 

[0388] The idea behind TCP wrappers is that, rather than allowing an incoming 
dient connection to communicate directly with a network service daemon running 
as a separate process on a server system, the target of the request is "wrapped" by 
another program, allowing a greater degree of access control and logging of who is 
attempting to use the service. 

[0389] The functionality behind TCP wrappers is provided by libwrap.a, a library 
that network services, such as xinetd, sshd, and portmap, are compiled against. 
Additional network services, even networking programs you may write, can be 
compiled again Ubwrap.a to provide this functionality. Red Hat Linux bundles the 
necessary TCP wrapper programs and Ubrary in the tcp_wrappers-<version> RPM 
file. 

[0390] When someone attempts to access a network service using TCP wrappers, a 
smaU wrapper program reports the name of the service requested and the client's 
host information. The wrapper program does not directly send any information 
back to the 

[039l]cUent, and after the access control directives are satisfied, the wrapper gets 
out of the way, not placing any additional overhead on the communication between 
the client and server. 
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[0392] TCP wrappers provide two basic advantages over other network service 
control techniques- 

[0393] The connecting client is unaware that TCP wrappers are in use. Legitimate 
users wiU not notice anything different, and attackers never receive any additional 
information about why their attempted connections failed. 

[0394] TCP wrappers operate in a manner that is separate from the applications the 
wrapper program protects. This allows many applications to share a common set of 
configuration fiiles for simpler management. 

[0395] Thus, an application program must be linked with the libwrap.a library. 
Once deployed to the field (i.e. a customer site), then the application program is 
static with well defined functionality. Thus, a replacement tcpwrapper cannot be 
used, unless the application program is recompiled (i.e., linked against libwrap.a) 
and redeployed. 

[0396] Another disadvantage is that tcpwrappers can be used to authenticate a 
request for a particidar application program from a client at given Internet Address, 
but does not authenticate individual services provided by the application program. 
A given application process can use tcpwrappers to authenticate based for the 
primary service provided by the application process, but, does not use tcpwrappers 
to authenticate for minor services provided by the appUcation process. 

[0397] By extending the capability to minor services offered by a primary service, we 
can provide a greater level of authentication and access control. 

[0398] By way of example, an authentication service embodiment is provided in 
Program Listing 3.0. The authentication service is used by the engine service. 
Thus, we can use tcpwrappers to authenticate for the engine service, and use our 
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own authentication service within the engine, based on the engine component 
specification. That is to say, when the engine service is configured, we can include 
the authentication service as a component of the engine. This permits 
authentication using client Internet Address to determine accessibility to one or 
more minor services provided by the application service. Alternatively, we could 
use the domain name associated with the requesting process. 

[0399] By way of example, an engine component providing input to the engine, can 
access and interact with the authentication service to determine if the requesting 
process has appropriate authorization to use the service provided by the input 
component. 

[0400] By way of example, an engine component providing preprocessing of input, 
can access and interact with the authentication service to determine if the 
requesting process has appropriate authorization to use the service provided by the 
preprocessing component. 

[0401] By way of example, an engine component can access and interact with the 
authentication service to determine an appropriate replacement component for the 
engine based on the chent credentials, which could include the Internet address, the 
domain name, or other information such as a variable name and value. By way of 
examples, an information could be "name=c.northrup." Various variable naming 
techniques, such as that provided by the KornShell command and programming 
language could be used. As another example, when a requesting process is 
executing on a computer within the enterprise (determined by examining the 
Internet Address of the requesting process), then the authentication service can be 
used to load a first service to decrypt the input. However, when the requesting 
process is executing on a computer outside of the enterprise (determined by 
examining the Internet Address of the requesting process), then the authentication 
service can be used to load a second service to decrypt the input. 
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[0402] The authentication service can access and interact with other services 
defined in this specification. By way of example, the authentication service can 
access and interact with the common directory service to query for accessible 
services, or for entities providing a service. The authentication service can query 
for general user information. 

[0403] The authentication service can access and interact with the services defined 
in US Patent 5,850,5 18, By way of example, the authentication service can access 
and interact with the Thread Directory Service to query for accessible services, or 
for entities providing a service, 

[0404] The authentication service can access and interact with a second 
authentication service based on the requesting process's Internet Address. By way 
of example, a first service is configured to access and interact with a first 
authentication service. When a requesting process accesses and interacts with the 
first service, then the first service accesses and interacts with the first 
authentication service. The first authentication service determines the requesting 
process is executing on a computer within the enterprise (i.e., within a given 
internet address range), and the first authentication service permits full access to 
the services provided by the first service. When the first authentication service 
determines the requesting process is executing on a computer outside of the 
enterprise, then the first authentication service accesses and interacts with a 
second authentication service to determine if the requesting process is 
authenticated. By way of example, the second authentication service may use a 
challenge response method, which is well known in the state of the industry, to 
verify that the requesting process has appropriate credentials. Alternatively, the 
second authentication service may configure the first service to use one or more 
different components such as a different decryption service. Alternatively, the first 
second authentication service may restrict access to one or more minor services 
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provided by the first service. Alternatively, the second authentication service may 
cause the first service to access and interact with a second directory service having 
a different set of registered services. In this manner, when the requesting process 
is executing within the enterprise, it can access and interact with a first common 
directory service, but, when the requesting process is executing on a computer 
outside of the enterprise, it can access and interact with a second common directory 
service distinct fi'om the first common directory service. Similarly, if the Internet 
Address of the requesting process cannot be determined, then a third common 
directory service distinct from the first and second, can be used. In this manner, we 
can control access to common directory services based on where the requesting 
process executes, how the requesting process communicates with the first service, or 
based on the information the requesting process provides to the first service, 

[0405] As part of the authentication service, the authentication service can access 
and interact with the common directory service to query for information 
components. By way of example, if the requesting process provides the 
authentication service with a unique identifier, the authentication service can 
access and interact with the common directory service to obtain the registration 
entry corresponding to the unique identifier. In this manner, the authentication 
service can configure a service based on the known registration information related 
to the requesting process. 

[0406] In this regard, the authentication service provides more than just examining 
the client Internet Address to determine if the client is allowed access to the 
primary service. In our invention, the authentication service provides the capability 
to: 

- authenticate access to the primary service based on the requesting 

process's Internet Address 
■ authenticate access to a minor service based on the requesting 

process's Internet Address 
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■ dynamically configure the components of a service, based on the 
requesting process's Internet Address 

dynamically configure the components of a service, based on 
information provided by a requesting process 

- access and interact with a common directory service to determine 
authentication service 

- access and interact with a common directory service to determine 
authentication service to use based on requesting process's network 
access point 

- select the common directory service accessible to the requesting 
process based on the Internet Address of the computer the requesting 
process is executing on. 

[0407] The authentication service can be implemented to determine the credentials 
of the requesting process, and determine what service directories should be used to 
configure the authentication service. By way of example, but not Umitation, the 
authentication service can use reverse domain name lookup to determine the 
domain name of the requesting process. With that information, the authentication 
service can then set environment variables, perform initiahzations, load services, or 
perform other actions so as to influence the behavior in satisfying the request. In 
one embodiment, using the Daytona data management system, the environment 
variable DS_APPS is set to the applications that are permitted (i.e., the associated 
tables and record class descriptions which collectively define the data being 
managed). Similarly, the environment variable DS_PATH defines one or more 
directories to search when looking for the associated service directories (ie., the data 
being managed). 

[0408] When a request is made to connect to a service, the request can be sent as 
components of information (possibly formatted similar to ksh environment variable 
rules), and using the requesting processes credentials (ie., the Internet domain 
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name associated with the requesting process connection on the client side), we can 
query the service directory for environment variables and perform the appropriate 
initiaUzation. A request, such as a command=query description="report sales for 
last month" would be queried against a first service directory when coming from a 
gtlinc domain, whereas the same request sent from a second company with a 
separate internet domain, would be queried against a second service directory. This 
method can also be used for registration such that when the request includes^ 

1. command=register description="pa3anent information" name=payservice 
[0409] Then the request will be executed against a service directory identified by the 
requesting process (client) credentials. 

[0410] Generic Front End Loading Service 

[0411] A generic front end loader (gfel) is used to initialize an address space for a 
service, and access and interact with the service. An example generic firont end 
loader is provided in Program Listings 9.1 through 9.4. Parameters are provided to 
gfel indicating name / value pairs. When a parameter name is given using the 
keyword primitive then gfel will register the indicated service with the directory 
service. As an example, using the parameters- 

[0412] name=da3rtime_service 
[0413] location=libservices.so. 1 -0 
[0414] primitive=INET 
[0415]physical=/local7tmp/ds_comprim 

[0416] will cause gfel to dynamically load the libservices.so.1.0 library, locate the 
daytime_service module within the library, and start the service listening on a unix 
domain socket given by the path name /tmp/ds_comprim. 

[0417] Alternatively, the parameters 
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[0418] name=da3rtime_service 
[0419] location=libservices.so. 1.0 
[0420] primitive=INET 
[0421]physical=192.168.20.15:9996 

[0422] will cause gfel to dynamically load the libservices.so.l.O library, locate the 
daytime_service module within the library, and start the service listening on a inet 
socket given by internet address 192.168.20.15 port 9996. 

[0423] In either case, the service is registered with the directory service. 

[0424] When gfel is used without the physical name / value pair, then gfel will 
estabhsh access and interact with the directory service to determine how to access 
and interact with the service given by the name= name/value pair. As an example, 
the specification- 

[0425] name=day time_service 

[0426] wiU cause gfel to access and interact with the common directory service to 
locate, and to access and interact with the daytime_service. 

[0427] Using the location and name parameters together, without the primitive or 
physical parameters, will cause gfel to dynamically load the service into the current 
gfel process. 

[0428] An implementation can use the common directory service to determine the 
appropriate actions for each of the name/value pairs provided to gfel. For example, 
a specification of- 
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[0429]nvpairs=tds name=route 

[0430] will cause the gfel to access and interact with the common directory service to 
determine a name service that gfel can access and interact with, to determine the 
appropriate actions for using the specification. In this context, the name / value 
pairs appearing in the specification to gfel, other than nvpairs=tds, are not 
processed by the gfel process itself, but rather, by a service that gfel will access and 
interact with. Thus, the remainder of the specification to the gfel process 
represents arbitrary named representations and gfel has no preconceived notion of 
what the arbitrary named representations represent. When combining this with 
the binding service of US patent 5,850,518, then gfel can use the binding service to 
determine what the arbitrary named representations represent. In one 
implementation, gfel may cause binding methods to be registered with the binding 
service, and then access and interact with the binding service to determine what the 
name/value pair represents, and how to process it. 

[0431] When gfel is to execute a service, then gfel will examine the service to 
determine if the service includes an administrative minor service. If so, then gfel 
will also accept requests from a requesting process to perform administrative 
capabiHties. Note that gfel wiU typically use two distinct mechanisms for accepting 
requests in this regard. By way of example, gfel can accept requests fi-om an 
administrative communication Mnk such as a Unix domain socket accessible only on 
the computer that gfel is executing on, and accept general requests from a request 
communication link such as an Internet socket. By way of example, gfel wiQ open a 
pathname to a unix domain socket such as /usr/share/gfel/engine/admin and accept 
administrative requests. Similarly, gfel will open a socket using the Internet 
Address and specified port to accept general requests for the service. In this 
manner, even whUe the primary service offered by gfel is executing, we can connect 
on the administrative link to access and interact with gfel to perform administrative 
functions, such as examining the state of gfel, examining the historic use data. 
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reconfiguring the service offered, change logging information, redirecting requests, 
or otherwise alter the basic behavior of the service without having to terminate and 
restart the service. This could include, for example, changing the Internet Address 
and/or port that gfel is using for general access and interaction. 

[0432] Payment Connection Service 

[0433] A consumer registers payment service (CPS) which is executing on consumer 
computer (CC). The registration is with common directory service (CDS). The 
registration information includes connectivity requirements and consumer the 
unique identifier (CID). Connectivity requirements can include one or more of^ an 
Internet Address, Port, protocol, access method, communication mechanism, or 
other information required for CDS to be able to communicate with CPS. Such 
communication can be communications communicated via computer mail. 

[0434] A service provider registers requesting service (SPRS) which is executing on 
service provider computer (SPC). The registration is with common directory service 
(CDS). The registration information includes connectivity reqxiirements and service 
provider the unique identifier (SPID). Connectivity requirements can include one or 
more of an Internet Address, Port, protocol, access method, communication 
mechanism, or other information required for CDS to be able to communicate with 
CPS. Such communication can be communications communicated via computer 
mail. 

[0435] SPRS communicates request to CDS. The request is to access and interact 
with CPS. SPRS provides CDS with SPID and CID. 

[0436] CDS registers a transaction in progress and assigns the unique identifier 
(TID). Registration includes TID, SPID, and CID. 
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[0437] CDS locates CPS registration, and communicates the unique identifier (TID) 
to CPS. CPS receives the unique identifier (TID). 

[0438] CPS connects to CDS. CPS communicates TID and CID to CDS. CDS locates 
registration entry for the unique identifier (TID), and CDS facilitates 
communication firom CPS to SPRS. CPS communicates payment information to 
SPRS, 

[0439] A first embodiment. Program Listing 14.0, provides a process service which 
can be included in an engine configuration specification. In this embodiment, the 
process service receives the tid fi-om the CDS. It then closes the connection fi-om 
CDS. It then opens a payment_info file, duplicates the file descriptor as file 
descriptor 0 which is standard input, and calls gfel to connect to the common 
directory service having the specified tid. The gfel service will invoke the talk2 
service which reads from standard input and sends to the connected service. 

[0440] A second embodiment, Program Listing 14.1, provides a process service which 
can be included in an engine configuration specification. In this embodiment, the 
process service receives the tid from the CDS, and also the SPID. It then accesses 
and interacts with the CDS to query for the registration information related to 
SPID. In then checks for an information component called Service Provider. If the 
information component is present, it prompts the user to determine if the user 
wants to accept the communication request fi-om the specified service provider. If 
the user does not enter yes, then the connection is declined. Otherwise, the request 
is accepted and CPS calls gfel to proceed as in the first embodiment. In this 
embodiment, the name of the service provider requesting payment information 
would be provided to the consumer. The consumer has the choice to accept or 
decline. Variations of the embodiment could include the use of a graphic display, or 
a graphic representation being displayed to the user. By way of example, the user 
could be presented with a graphic representation of ACCEPT and a DECLINE, and 
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then using a pointing device such as a computer mouse, the user could select the 
desired option. The software component responsive to the mouse click, would then 
accept or decline the request for payment information. This could also include 
displaying the name of the service provider and possibly other registered 
information related to the service provider. In yet another embodiment, the service 
provider could communicate the amount due and that information could also be 
presented to the consumer. In this manner, it would give the consumer a second 
chance to ensure they agree to the transaction. 

[0441] When the consumer is using a computer with a monitor, keyboard, mouse, 
and means of graphical display, that when the CPS is started, it would display a 
graphical representation indicating that the CPS is running. In a first 
implementation, this may include a graphical representation such as a waUet being 
open. When the CPS terminates, the graphical representation would depict a wallet 
being closed. Customization could include a graphical icon of a purse being open 
when CPS is running, and a graphical icon of a piurse being closed when CPS is not 
running. In other implementations, when CPS registers with CDS, it can receive a 
communication representative of a first graphical representation to display when 
CPS is running. Similarly, it can receive a second graphical representation to 
display when CPS is no longer running. Note that if a graphical representation is 
displayed indicating CPS is no longer running, then a component of software can be 
responsive to the consumer using a pointing device such as a mouse "chck", to cause 
CPS to start running. In such cases, the graphical representation would then be 
changed to indicate that CPS is running. In this context, CPS woidd start 
executing and would register with CDS. When CPS registers with CDS, it can 
indicate to CDS that CPS already has graphical representation information and 
such information would then not need to be provided by CDS. 

[0442] A third embodiment, Program Listing 14.2, provides a process service which 
can be included in an engine configuration specification. In this embodiment, the 
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process service receives the tid from the CDS, as well as various acceptable 
payment types to the service provider. In this embodiment, CPS matches the 
payment types accepted by the service provider to those recorded in the 
payment_info file accessed by CPS to match up the information requested with the 
payment information to be provided by CPS. Midtiple variations to the embodiment 
are possible including implementing a preferred payment type by the consumer in 
which case CPS would determine if the preferred payment type is accepted by the 
service provider before choosing other payment types. In another variation to the 
embodiment, a graphical display may appear on the consumer computer monitor 
(display) indicating one or more matching payment types, and permitting the 
consumer to select the preferred payment type for that transaction. In yet another 
variation, the graphical representation of the various payment types available by 
the consumer could be displayed, and, when matched against those payment types 
supported by the service provider, the graphical representation could be changed to 
a second graphical representation, such as highhghting, to indicate that the 
payment type is acceptable. The consumer could then depress the mouse button to 
"click" on one of the highlighted graphical representations to indicate which of the 
payment types the consumer wishes to use. 

[0443] In another variation, the CPS could be designed to monitor for 
communication communicated via computer mail protocol. In doing so, the CPS 
would register with the CDS that the CDS should communicate pending 
connections (transactions) to CPS via computer mail. When a computer mail 
message is received on the CC, the CPS would examine the mail message to 
determine if it is an appropriate pending transaction communicated from CDS. If 
so, then CPS would read the unique identifier (TID) and connect to CDS. CPS 
communicates the unique identifier (TID) and CID to CDS. CDS locates 
registration entry for the unique identifier (TID), and CDS facilitates 
communication from CPS to SPRS. CPS communicates payment information to 
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SPRS. Note that once CPS accesses and interacts with CDS, then SPRS could send 
to CDS other information components that are required. 

[0444] In another embodiment, CPS could be registered with a common directory 
service wherein CPS acts as a conduit to a second component of software. In this 
embodiment, the second component of software could access and interact with a 
database system to query for payment information and provide same to CPS instead 
of having CPS open and read an accessible file. 

[0445] In another embodiment a dual callback system can be used. In this 
embodiment, SPRS accesses and interacts with CDS to request payment 
information service for consumer with CID. CDS receives CID and SPID firom 
SPRS. CDS creates a transaction in progress registration and assign a unique 
identifier (TID). The registration including SPID, CID, and TID. CDS then 
disconnects from SPRS. CDS uses CID to locate CPS registration, and connects to 
CPS, and communicates the unique identifier (TID) to CPS. CPS receives the 
unique identifier (TID). CPS disconnects from CDS and CDS disconnects fi-om CPS. 
CPS connects to CDS. CPS communicates TID and CID to CDS. CDS locates 
registration entry for the unique identifier (TID). CDS updates the unique 
identifier (TID) entry with pending transaction information recording CDS process 
having CDS connection open. CDS uses SPID of registration entry corresponding to 
the unique identifier (TID), to locate SPRS entry. CDS connects to SPRS and sends 
the unique identifier (TID). SPRS receives the unique identifier (TID). SPRS 
disconnects from CDS and CDS disconnects from SPRS. SPRS calls CDS and sends 
SPID and TID. CDS, responsive to receiving SPID and TID, locates TID entry. 
CDS accesses and interacts with pending transaction information of the recorded 
CDS process having CDS connection open to pass file descriptors to said CDS 
process. CDS then notifies recorded CDS process to facilitate communications. CPS 
then communicates payment information to SPRS. 
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[0446] Note that the method of the payment service can be used to facilitate other 
such services. By way of example, CPS could be a contact service providing 
consumer contact information. In such cases, the SPRS would be requesting access 
to the contact service instead of the payment service for the specified consumer. 
SPRS could provide to CPS the information component name or names that it is 
looking for. CPS could then fill in the response. The CDS would facilitate 
communication just as it does for the CPS providing payment information. 

[0447] Alternatively, CPS could be corporate information such as that which would 
normally appear in a Dunn & Bradstreet (D&B) report. In such cases, the SPRS 
would be requesting access to the corporate information associated with a particular 
the unique identifier. Thus, the SPRS could send the desired service type for a 
particular the unique identifier to CDS, and CDS could locate the service and 
facilitate the connectivity as described in this specification. 

[0448] A Data Sharing Service 

[0449] A first process of a first computer of the network accesses and interacts with 
a directory service to register the first process as providing a particular type of data, 
such as an Excel spreadsheet template, an Excel spreadsheet formula, an encoded 
voice stream, a video stream, voice and video stream, genealogy information, 
medical records information, financial data, or the like. The registration 
information includes the connectivity required to reach the service. The 
registration information could also include one or more of the registration 
information components described in US Patent 5,850,518, such as the input types 
understood by the service, the output types, or the data representation used in 
communicating with the service. The first process listens for a request. By way of 
example, the first process could register a description of "northrup genealogy" and 
connectivity information of "elmer.gtUnc.com:9999" where elmer.gtlinc.com is the 
name of a computer within the gtlinc.com domain, and 9999 represents the port 
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that the first process is listening on. Using standard name services, the registration 
process can convert the name elmer.gtlinc.com to an Internet Address, or the, the 
directory service can use the domain name service to determine the Internet 
Address when needed. 

[0450] A second process of a second computer of the network accesses and interacts 
with the directory service to request access to the first service. By way of example, 
the second process could provide criteria description="northrup genealogy". The 
directory service, responsive to receiving the request, locates the first service 
registration entry and accesses the registration entry. The directory service then 
facilitates the connectivity to the first service. 

[0451] The invention is not limited to data stream processing. The underlying 
communication could be implemented through various protocols and various 
communication methods such as through sockets. 

[0452] Medical Test Results Reporting Service 

[0453]HIPAA (Health Insurance Portability and Accountability Act of 1996) 
regulations have been put into law which clearly define the treatment of patient 
information by health care providers. These regulations cover both patient privacy 
standards as well as security standards that the health care provider must adhere 
to with respect to digital patient data. 

[0454] Medical test results reporting can be automated within the HIPAA 
regulations via a service. The service can be provided by the health care provider, 
or by a third party service provider. 

[0455] The health care provider summarizes the results of medical tests in a format 
to be made available to the patient. This may include an image scan of a printed 
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lab report, physician notes, or other means of documentation. In a preferred 
embodiment, the scan images woidd be saved in an industry standard fQe format 
such that a viewer can be used to view the images (hardware to provide same and 
software is provided by Hewlett Packard's ScanJet Scanner). This information is 
then recorded in a data store. 

[0456] The medical test results in the data store are encrypted with a digital key 
that is stored and will be made available only to the patient. Alternatively, just 
prior to providing the results, the software service will encrypt the data from the 
data store according to the patient digital key. 

[0457] The health care provider notifies the patient that the medical test results are 
available. Such notification can be via telephone, email, or other means such as 
software notification. 

[0458] The health care provider communicates the unique id of the results to the 
patient. 

[0459] The patient registers with the health care provider service and receives a 
unique id (PID). This must be completed before the patient can retrieve the test 
results. 

[0460] The patient becomes aware of the avaUability of the test results. Using the 
PID and the unique id of the test results, the patient connects to the service and 
retrieves the medical test results. 

[0461] In a first embodiment, the Health Care Provider (HCP) maintains computer 
(HCC) with communication device. The HCP provides a directory service (HDS) 
executing on HCC. HCP registers patient with directory service and patient is 
assigned a unique identifier (PID). The HCP registers a service to provide lab test 
results (HCLRS) to patient (PID). The registration is assigned a unique identifier 
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(TID), and the registration records PID. HCP communicates the unique identifier 
(TID) to patient with PID. Patient with PID uses computer (PCC) with a 
communication device, to start a first process on PCC. The first process accesses 
and interacts with HDS. The first process provides PID and TID to HDS. HDS 
locates the TID entry, and facilitates connectivity to HCLRS. HCLRS, responsive to 
the connectivity, provides first process with medical test results. The first process 
uses the digital key known to patient with PID to decrypt the results, and display 
the results to the patient. 

[0462] In a second embodiment, the Health Care Provider (HCP) maintains 
computer (HCC) with communication device to permit communication with the 
network. The HCP provides a directory service (HDS) executing on HCC. HCP 
registers patient with directory service and patient is assigned a unique identifier 
(PID). Patient with PID maintains and uses computer (PCC) with communication 
device to permit communication with the network. Patient causes sofl:ware service 
PSS to begin executing on PCC. PSS accesses and interacts with HDS to register 
PSS and connectivity required to reach PSS. 

[0463] The HCP registers a service to provide lab test resvQts (HCLRS) to patient 
(PID). The registration is assigned a unique identifier (TID), and the registration 
records PID. HCLRS accesses and interacts with HDS, causing HDS to locate PSS 
entry, access PSS entry, and to access and interact with PSS. HDS provides PSS 
with the unique identifier (TID). PSS accesses and interacts with HDS, providing 
HDS with PID and TID. HDS locates the registration entry with PID and TID, and 
facilitates connectivity to HCLRS. HCLRS, responsive to the connectivity, provides 
first process with medical test results. The first process uses the digital key known 
to patient with PID to decrsrpt the results, and display the results to the patient. 

[0464] In a third embodiment, the Health Care Provider (HCP) maintains computer 
(HCC) with communication device to permit communication with a network. The 
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HOP uses a component of software to register with a common directory service 
executing on a second computer of the network. HCP is assigned a unique identifier 
(HCID). 

[0465] Patient uses a computer PCC with communication device to permit access to 
network. Patient causes a component of software to be executed and patient 
registers with common directory service. The registration including a unique 
identifier (PID) uniquely qualifying the patient from other registered patients. 

[0466] Patient causes software service PSS to begin executing on PCC. PSS 
accesses and interacts with common directory service to register PSS and 
connectivity required to reach PSS. 

[0467] The HCP registers a service to provide lab test results (HCLRS) to patient 
(PID). The registration is assigned a unique identifier (TID), and the registration 
records HCID and PID. HCLRS accesses and interacts with common directory 
service, causing common directory service to locate PSS entry, access PSS entry, 
and to access and interact with PSS. PSS is provided the unique identifier (TID). 
The access and interaction now complete, and the common directory service 
disconnects fi'om the communication with PSS. 

[0468] PSS accesses and interacts with common directory service, providing common 
directory service with PID and TID. The common directory service locates the 
registration entry with PID and TID, and facilitates connectivity to HCLRS. 
HCLRS, responsive to the connectivity, provides medical test results. The PSS uses 
the digital key known to patient with PID to decrypt the results, and display the 
results to the patient. 

[0469] In a fourth embodiment, the Health Care Provider (HCP) maintains 
computer (HCC) with communication device to permit communication with a 
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network. The HCP uses a component of software to register with a common 
directory service (CDS) executing on a second computer of the network. HCP is 
assigned a unique identifier (HCID). 

[0470] Patient uses a computer PCC with communication device permitting access 
to network. Patient causes a component of software to be executed and patient 
registers with CDS. The registration including a unique identifier (PID) uniquely 
qualifying the patient from other registered patients. 

[0471] Patient causes software service PSS to begin executing on PCC. PSS 
accesses and interacts with CDS to register PSS, the registration including PID and 
connectivity required to reach PSS. 

[0472] The HCP uses a component of software to register with CDS, a service to 
provide lab test results (HCLRS) to patient (PID). The registration is assigned a 
unique identifier (TID), and the registration records HCID and PID. 

[0473] CDS locates PSS registration entry having PID and PSS, access the entry, 
and connects to PSS. CDS communicates the unique identifier (TID) to PSS. CDS 
disconnects from PSS communication link. 

[0474] PSS connects to CDS, and sends PID and the unique identifier (TID). 

[0475] CDS, responsive to receiving PID and TID, locates the registration entry with 
PID and TID, and connects to HCLRS. CDS uses file descriptor passing techniques 
to pass the file descriptor of HCLRS to PSS. 

[0476] HCLRS encrypts medical test results and sends the results to PSS. PSS 
receives the results, and uses the digital key known to patient with PID to decrypt 
the results, and displays the results to the patient. 
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[0477] Alternatively, the health care provider may choose to use a third party to 
host the reporting service. Using this method, the provider posts the availability 
notice to the third party provider, who in turn notifies the patient of the 
availability. When ready to retrieve the results, the patient service connects to the 
third party service, which in turn then connects to the health care provider. During 
the ensuing transaction, the patient service is delivered the results of the lab tests. 

[0478] Physician Pharmaceutical Service 

[0479] A pharmacist uses a computer (PCC) with operating system with interfaces 
for communication connectivity and synchronization, and a communication device, 
to execute a component of software which registers pharmacists with common 
directory service (CDS) running on a second computer of the network. The 
pharmacist is assigned a unique identifier (PHARMD). 

[0480] A doctor uses a computer (DCC) with operating system with interfaces for 
communication connectivity and synchronization, and a communication device, to 
execute a component of software which registers doctor with CDS and is assigned a 
unique identifier DID. 

[0481] A patient is registered with CDS and is assigned a unique identifier PID. 
The patient could uses a computer (HCC) with operating system with interfaces for 
communication connectivity and synchronization, and a communication device, to 
execute a component of software which registers patient with CDS and is assigned a 
unique identifier PID. Alternatively, the doctor or an assistant thereof can register 
patient with CDS. 

[0482] The doctor prescribes a prescription for patient and records the prescription 
in a data store. 



Page 101 of 229 



Marked-Up Version of Subsitute Specification 
Application 10/068,077 



[0483] The doctor uses computer to execute a component of software (MDS) to 
provide PID prescription information. MDS connects to CDS and registers as a 
service, the registration including the connectivity required to reach the service, 
and the DID. 

[0484] The patient visits PHAEMD office and provides PHARMD with their PID, 
and their doctor's name (or DID). The pharmacist uses a component of software 
(COS) on PCC to connect to CDS and request prescription information for patient 
PID, the request including the DID (or doctor's name). 

[0485] CDS registers the request as a pending transaction and assigns the unique 
identifier (TID), the registration including DID and PID. 

[0486] CDS uses DID as criteria to locate MDS registration and connects to MDS. 
CDS sends TID to MDS. MDS receives TID. CDS and MDS disconnect. MDS 
connects to CDS and provides TID and DID. CDS locates the unique identifier 
(TID) entry and facilitates communication to COS. MDS then provides COS with 
prescription information. 

[0487] In a preferred embodiment, the prescription information would be encrypted 
according to a digital certificate. In this manner, when MDS provides the 
prescription information, the information would be encrypted. It is noted that COS 
would need to decrypt the information. In one embodiment, the digital certificate 
would be that of the pharmacist. In a second embodiment, the digital certificate 
would be assigned and known to the patient. In a third embodiment, the digital 
certificate would be known to the doctor. In any case, the doctor software MDS 
woxild need to have access to the digital certificate, as would the COS. 

[0488] Data Store Forwarding Service 
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[0489] A challenge with software services is that the corresponding process must 
also be accessible to the network. There are times, however, when due to power 
failiires, network interruptions, scheduled down time, and the other situations, 
where the computer or the corresponding process may not always be accessible via 
the network. 

[0490] When the service is to provide a stream of data, it is desirable to offer that 
data even if the host computer is not accessible. To resolve this limitation, a 
recording service is provided, along with a playback service. 

[0491] This permits a first process of a first computer of the network, to connect to a 
recording service to record data provided by the first process. The recording service 
will record the data to a data store, and assign a unique name to the data. By way 
of example, a unique fiile name can be used when the data store is a standard file. A 
playback service, given the unique name to the data, can access and playback the 
data to a requesting process. 

[0492] The recording service can be a first process of a first computer of the network, 
listening for requests on a network endpoint, such as an Internet Address and port. 
The recording service accepts a connection firom a requesting process, and records 
whatever the requesting process sends, to a data store, such as a file. The file is 
uniquely named. The recording service can be registered with a common directory 
service running on a second computer of the network. Program Listing 14.3 
provides an embodiment of a recording service process for a software engine, or for 
use with gfel. 

[0493] The playback service can be a third process of the first computer of the 
network, listening for requests on a given network endpoint, such as an Internet 
Address and port. The playback service accepts a unique name, accesses and 
interacts with a data store defined by the unique name, and commxmicates the 
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contents thereof. The playback service can be registered with the common directory 
service. Program Listing 14.4 provides an embodiment of a recording service 
process for a software engine, or for use with gfel. 

[0494] By connecting to the recording service, a requesting process can retrieve a 
unique file name, and can send data to be recorded by the recording service. The 
playback service can be registered with the common directory service. A second 
requesting process can then connect to the common directory service to locate the 
playback service, and can provide the playback service with the specified unique file 
name. The second requesting process would then receive the contents of the data 
previously recorded by the recording service. 

[0495] In an alternative embodiment, the playback service could erase the contents 
of the data store given by the unique identifier after the playback has occurred. 
Similarly, the playback service could connect to the common directory service and 
cause the registration entry for the playback service to be deleted. 

[0496] In an alternative embodiment, the playback service can determine the data 
type by examining the content of the data, in order to determine playback modes. 
By way of example, this would be comparable to using a mime type to determine the 
playback software that is to be used. 

[0497] Academic Transcript Service 

[0498] School grades are considered private information, and cannot be disclosed to 
third parties. Providing current grades and academic transcripts via the world wide 
web is less then secure in the current state of the art. To address this concern, an 
Academic Transcript Service is provided. 
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[0499] An educational institution uses a computer with communication device and 
an operating system with interfaces for communication connectivity and 
synchronization (ACC) to access network. 

[0500] A student is registered with common directory service and assigned a unique 
identifier (SID). 

[0501] The academic institution is registered with the common directory service and 
assigned a unique identifier (AID). 

[0502] A student uses a computer with communication device and an operating 
system with interfaces for communication connectivity and synchronization (SCC) 
to access network. 

[0503] The Academic Institution runs an academic reporting service (AKS) on ACC. 
ARS registers with common directory service, the registration including 
connectivity requirements to reach AES. 

[0504] The student executes a component of software (RADAR) on SCC, the 
component of software designed to request and display academic records. The 
student provides RADAR with SID. RADAR connects to the common directory 
service and request academic records for SID. The common directory service 
receives the request and records SID and AID into a transaction registration entry, 
the transaction being assigned a unique identifier (TID). CDS connects to ARS and 
sends the unique identifier (TID). ARS receives TID and both ARS and CDS 
disconnect from the communication. ARS then connects to CDS and provides AID 
and TID. CDS, responsive to receiving AID and TID, locates the corresponding 
transaction entry and facilitates connection to RADAR. ARS provides RADAR with 
academic transcripts, and RADAR receives and processes the academic transcripts. 
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[0505] In a second embodiment, student is registered with CDS and assigned SID. 
The academic institution is registered with CDS and assigned AID. The Academic 
Institution runs an academic reporting service (ARS) on ACC. ARS registers with 
common directory service, the registration including connectivity requirements to 
reach ARS. 

[0506] RADAR begins executing on SCC. Student provides RADAR with SID. 
RADAR registers with CDS, the registration including SID and connectivity 
required to reach RADAR. 

[0507] RADAR connects to CDS and request academic records for SID. The request 
can include AID or academic institution name which can be used to locate AID. 
CDS registers the request as a transaction in progress and assigns a unique 
identifier (TID). The registration entry can include AID. CDS and RADAR then 
disconnect. 

[0508] CDS locates ARS entry, connects to ARS, and sends TID. ARS receives TID. 
Both CDS and ARS disconnect. 

[0509] ARS connects to CDS. ARS sends AID and TID to CDS. ARS receives from 
CDS, the SID. ARS uses SID to access and interact with datastore having academic 
transcripts. ARS accesses the transcripts. 

[0510] CDS, responsive to receiving AID and TID, locates RADAR registration entry 
using SID as the lookup value. CDS creates registration entry for active ARS 
session, and assigns a unique identifier ATID. CDS connects to RADAR and sends 
RADAR the ATID. RADAR receives ATID. RADAR and CDS then disconnect from 
the communication Unk. 
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[0511] RADAR connects to CDS and sends ATID and SID. CDS, responsive to 
receiving ATID and SID, locates registration entry and facilitates communication 
connectivity between RADAR and ARS. ARS then communicates academic 
transcripts. When complete, RADAR, ARS, and CDS all disconnect from the 
communications. 

[0512] Public Office Election Service 

[0513] Many have considered using the Internet for general elections. The beUef is 
that more registered people would participate in the voting if permitted to vote over 
the Internet, instead of driving to drive to a local school. The challenge, of course, is 
the lack of security and the mechanisms to institute elections over the Internet. To 
address this concern, an election service is provided. 

[0514] An election office, or appropriate authority, uses a computer with 
communication device and an operating system with interfaces for communication 
connectivity and synchronization (ECC) to access network. 

[0515] A registered voter is registered with common directory service and assigned a 
unique identifier (VID). 

[0516] The authorizing agency is registered with the common directory service and 
assigned a unique identifier (EID). 

[0517] A voter uses a computer with communication device and an operating system 
with interfaces for communication connectivity and synchronization (VCC) to access 
network. 
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[0518] The authorizing agency runs an election service (ES) on ECC. ES registers 
with common directory service (CDS), the registration including connectivity 
requirements to reach ES. 

[0519] The voter causes software (VCS) to execute on VCC. VCS connects to CDS 
and request access to voting information. CDS locates ES registration entry, and 
facilitates communication connectivity on behalf of VCS to ES. 

[0520] ES provides VCS with voting information. The information containing 
candidate information. The information could contain instructions. The 
information could contain additional information such as political party, desired 
office, the term of office, or other such information as woidd be useful to the voter. 
Once complete, ES, VCS, and CDS all disconnect from the various communication 
links. 

[0521]VCS requests VXD from voter. The voter provides VID to VCS. The voter 
also selects the desired candidate (either through mouse click, pointing device, 
touch screen, voice, keyboard, keypad, or other mechanism as one skilled in the 
state of the art woidd understand, or via an industry standard method for providing 
input to a software service). 

[0522] VCS connects to CDS and request access to ES. VCS provides CDS with VID. 
CDS creates a transaction in progress registration entry and assigns a unique 
identifier (TID). The registration entry including connectivity information required 
to reach VCS. VCS then disconnects fi-om CDS. CDS connects to ES and provides 
ES with the unique identifier (TID). ES receives the unique identifier (TID). ES 
and CDS disconnect. 

[0523]ES connects to CDS and provides EID and TID. CDS locates TID entry. CDS 
uses connectivity information to connect to VCS and provides VCS with TID. VCS 
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receives TID. CDS and VCS disconnect. VCS connects to CDS and provides VID 
and TID. VCS locates TID entry and facilitates communication connectivity on 
behalf of VCS to ES. VCS then provides ES with voter supplied information. 

[0524] Medical Records Service 

[0525] Extensive, accurate and up-to-date medical records may not always be 
available in times of urgent need. A Medical Records Service provides a means to 
make an individual's complete medical record available to a health care provider 
while controlling access and ensuring privacy. 

[0526] To use the service, the patient registers with the third party Medical Records 
Service, creating a common directory service (CDS) entry for the patient and 
obtaining a unique identifier (PID). The entry also includes a hmited-use personal 
identifier (LUPID). 

[0527] Health care providers interested in using the service also register with CDS, 
creating a CDS entry and obtaining a unique identifier (HCPID). 

[0528] The health care provider registers with CDS, a Health Care Reporting 
Service (HCRS) executing on health care provider's computer having a 
communication device and an operating system with interfaces for communication 
connectivity and synchronization. CDS creates a registration entry and assigns the 
unique identifier HCRSID. 

[0529] When a patient visits a health care provider, the health care provider creates 
a record in CDS indicating that care has been provided for that patient. Medical 
records are not stored in CDS, it contains only a record of the relationship between 
the patient with PID and the provider with HCPID. 
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[0530] When the medical records for a patient need to be referenced (by an 
emergency room staff, for example), the patient consents by providing the inquiring 
party with PID and LUPID. It is noted that the inqiiiring party must also be 
registered with CDS and have a unique identifier (IPID). 

[0531] The inquiring party uses a component of software (COS) on a computer 
having a communication device and an operating system with interfaces for 
communication connectivity and synchronization to request medical records for 
patient with PID and personal identifier LUPID. CDS receives the request and 
creates a transaction in progress registration entry, assigning a unique identifier 
(TID). CDS accesses the registered entries for PID to determine HCPID. 

[0532] CDS uses HCPID to lookup the health care provider HCRS service. Once 
located, CDS connects to HCRS and sends the unique identifier (TID). HCRS 
receives the unique identifier (TID) and disconnects, as does CDS. HCRS then 
connects to CDS and provides HCPID and TID. CDS receives HCPID and TID, and 
locates corresponding registry entry for TID. COS then facilitates communication 
connectivity with COS. HCRS then sends to COS the records for patient PID. 
[0533] In a preferred embodiment, the communicated patient medical records would 
be encrypted according to a certificate. The certificate would have to be known by 
either the Health Care Provider and the inquiring party, in order to decrsrpt the 
data. In one embodiment, the certificate could be the LUPID, as it is available to all 
parties. In a second embodiment, the certificate could be the PID, or the HCPID, or 
the IPID. In any case the certificate for public key encryption or the equivalent 
thereof, must be known by the corresponding parties. 

[0534] Resume Matching Service 

[0535] Due to privacy concerns, it is not always desirable to post one's resume on 
public bulletin boards or job posting sites. Likewise, it is expensive for employers to 
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use employment agencies, classified advertisements and job websites to post job 
openings. A resume matching service provides a private, secure method of 
matching job applicants to companies with job openings, 

[0536] Individuals register with a third party that provides the service. The 
registration is anonymous. Registration includes job history, education and other 
typical data included on a resume. 

[0537] Companies register with a third party that provides the service. The 
registration is not anonymous. Companies provide such information as company 
background, location, benefits, etc. that are of interest to job seekers. 

[0538] When a company has a job opening, the description of the job is posted to the 
directory service. Details include job title, salary, education requirements, location, 
start date, etc. 

[0539] When individuals wish to search for job openings, they connect to the 
directory service and indicate availability, along with salary requirements. The 
resume matching service scans available job postings by companies and matches 
the job seeker's data to the job opening. Matches are retrieved and sent to the 
individual for review. The individual scans the job openings, along with the 
company information posted in the directory service. Each job opening is either 
rejected or accepted. When a job opening is accepted, the service is contacted, and 
the individual's resume is sent to the company, along with personal contact 
information for the individual. When there is a mutual interest, a job interview is 
scheduled. 

[0540] Company Credit Reporting Service 
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[0541] Obtaining credit information on potential customers is useful prior to 
establishing credit terms. Although commercial services are available to obtain 
such information, the cost may be prohibitive for many businesses. An alternative 
Credit Reporting Service makes this possible. 

[0542] Companies register with the third party Credit Reporting Service, creating a 
directory service entry and obtaining a unique identifier. Registration indicates the 
company's participation and willingness to share data on their credit history with 
other companies. 

[0543] Companies also register entries in the central directory service indicating 
those other companies with which they have done business. Companies contribute 
their own credit experience with other companies to their own Credit History 
Service, which can be accessed via the central directory service. 
[0544] Third party services provided value-added services such as public records 
reporting, credit scoring, etc., for a fee for specific queries against the central 
directory service. 

[0545] A Prepay Service 

[0546] Various payment methods have been used for electronic commerce. The 
prepay service is a method for maintaining secure payment information. 

[0547] A consumer uses a computer with communication device and an operating 
system with interfaces for communication connectivity and synchronization to 
execute an APS component of software. The consumer interacts with APS to 
provide registration information. APS registers consumer with common directory 
service (CDS), and consumer is assigned a unique identifier (CID). 
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[0548] A service provider uses a computer with communication device and an 
operating system with interfaces for communication connectivity and 
synchronization to execute a PS component of software. The service provider 
interacts with PS to provide registration information, PS registers service provider 
with common directory service (CDS), and service provider is assigned a unique 
identifier (SPID). 

[0549] Service provider causes PS to execute and PS accesses and interacts with 
CDS to register as a prepay service, the registration including connectivity 
requirements to reach PS. 

[0550] Consumer uses APS to prepay services. APS accesses and interacts with 
CDS to locate prepay service PS. Consumer specifies the amount of prepaid service 
desired. Consumer uses payment service described elsewhere in this specification 
to pay for the prepaid service. By way of example, consumer authorizes $50 prepaid 
service to be billed to consumer's American Express credit card. The prepay service 
(PS) receives payment information and causes the consumer's American Express 
account to be billed $50. The prepay service (PS) registers the credit with a 
directory service, the registration including the CID, the outstanding credit amount, 
and a unique identifier (AMD). The prepay service sends the ANID to APS. APS 
receives the ANID and records in the payment information file a prepaid payment 
type and account ANID. 

[0551] In subsequent uses of the payment service, the service provider receiving the 
payment information would access and interact with CDS to locate the prepay 
service. Once located the service provider software would then request a debit to 
the ANID account for CID. The prepay service would provide service provider with 
a separate authorizing payment information to bill against. In a preferred 
embodiment, this would include a mastercard account, expiration date, and 
cardholder information. 
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[0552] In an alternative embodiment, the consumer payment service (CPS) would 
receive the bill amount from SPRS. CPS can access and interact with CDS to locate 
prepay service and send ANID, CID, and bill amount to prepay service. The prepay 
service, responsive to receiving ANID, CID, and biU amount, would locate 
registration entry for ANID and would authorize payment of bill amount to credit 
card held by service provider. In doing to, the prepay service would communicate 
the payment information (i.e., card holder, credit card type, credit card number, 
credit card expiration) to CPS which would then communicate that information to 
SPRS. 

[0553] In an alternative embodiment, the prepay service would be used in place of 
the CPS. This, however, requires registration with CDS to indicate that prepay 
service should be used for providing payment service for CID. In such cases, it is 
preferable for the prepay service to make such registration information available to 
CDS. Thus, when SPRS request payment information service for CID to CDS, then 
CDS would record the unique identifier (TID) and communicate the CID and TID to 
prepay service, and prepay service would validate the CID and provide payment 
information to SPRS. This would permit the prepay service to provide SPRS with a 
temporary credit card with a preset limit not to exceed the balance due to the 
service provider SPID. 

[0554] Translation Service 

[0555] Language translations such as Japanese to English or vice-a-versa, are offcen 
desirable. The google search engine offered at httpV/www.google.com provides a 
translation service for cached HTML documents. When a user of the network 
receives email in a foreign language, there are no translation services via the 
Internet to provide translation from a first language to a second language. 
Similarly, there are no services to translates from a first language to a second 
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language when sending email. Yet electronic mail is one of the most widely used 
services of the Internet. 

[0556] A service provider can register with common directory service (CDS) and is 
assigned a unique identifier (SPID). The service provider provides a language 
translation service (LTS) component of software on service provider computer 
(SPCC). The service provider causes LTS to execute on SPCC. LTS registers with 
CDS. The registration including the connectivity required to reach LTS. 

[0557] A consumer can use a component of software (COS) on consumer computer 
(CC) to register with CDS. The consumer is provided a unique identifier (CID). 

[0558] The consumer can use a component of software (SCOS) on consumer 
computer (CC) to request CDS to connect with a language translation service 
providing translation from English to Chinese. CDS locates LTS registration entry, 
and creates a transaction in progress registration entry, assigning a unique 
identifier (TID). CDS connects to LTS and sends TID to LTS. LTS receives TID 
and disconnects from CDS, as well as CDS disconnecting from LTS. LTS connects 
to CDS and provides SPID and TID, CDS locates TID entry and connects LTS to 
SCOS. 

[0559] In this manner, SCOS can communicate information to LTS which is to be 
translated from English to Chinese. When complete, LTS, SCOS, and CDS all 
disconnect from the communication. 



[0560] Note that in a first embodiment, CDS coxdd provide SCOS with the 
connectivity required to reach LTS independent of CDS. In a second embodiment, 
CDS can disconnect after the connection has been made between LTS and SCOS. 
In a third embodiment the data representation to be communicated to LTS may 
require translation from a first format to a second format. In this manner, various 
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brokers can be dynamically loaded to provide such translation. By way of example, 
if SCOS is communicating an unformatted component of an electronic mail message 
to be translated, and LTS requires the format to be HTML, then a broker service 
can be used to provide translation for the unformatted text to be formatted 
according to HTML rules. Similarly, the results of LTS may be communicated in 
HTML format. Thus, a broker service can be used to provide translation from 
HTML format to unformatted content. 

[0561] An Environment Service 

[0562] An environment service starts out as a process essentially representing a 
vacuum, such as empty space. There are no objects, no services, nor anjrthing of 
interest in the environment. 

[0563] A requesting process having appropriate authorization can connect to the 
environment service and specify that a service is to be executed within the 
environment, the service being a controlling service, in which case, the controlling 
service acts as the administrator of the environment. 

[0564] A requesting process having appropriate authorization, can connect to the 
environment and induce a behavior by requesting a first service to be executed 
within the environment. The controUing service accesses and interacts with the 
directory service to locate the desired first service and causes the service to effect 
the environment. By way of example, this can include loading the service and 
executing the service as a thread. Alternatively, the controlling service could 
connect to the first service and communicate with the service. The controlling 
service registers the first service in an environment directory service (registry). 

[0565] A requesting process having appropriate authorization, can connect to the 
environment and induce a behavior by requesting a second service to be executed 
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within the environment. The controUing service accesses and interacts with the 
directory service to locate the desired second service and causes the second service 
to effect the environment. By way of example, this can include loading the service 
and executing the second service as a second thread. Alternatively, the controlling 
service could connect to the second service and communicate with the second 
service. The controlling service registers the second service in an environment 
directory service (registry). 

[0566] The first service and the second service can compete for computing resources, 
discover each other through querying the environment directory service, and 
otherwise interact with each other as deemed appropriate. Alternatively, the 
controlling service can determine the interactions between the first service and the 
second service, or otherwise assist in their influencing their behavior. 

[0567] By way of example, a first service can represent an atom, such as a hydrogen 
atom. A second service can represent an atom such as an oxygen atom. A third 
service can represent a second oxygen atom. When the controlling service 
recognizes the atoms and has means to bind the atoms, then the controlling service 
can induce a fourth service representative of a water moleciile, and cause the first, 
second, and third service to be suspended, as they are now part of the fourth 
service. Alternatively, the first, second, and third service may be able to execute, 
but only within the environment of the fourth service. In such cases, the controlling 
service would create a new environment and register the first, second, and third 
service within that environment. By way of example, the controlling service creates 
a new directory service registry and moves the first, second, and third service 
registration fi-om the current environment registry to the new directory service 
registry. The controlling service may also suspend, or otherwise lower the priority 
values of the services are deemed appropriate. When the embodiment includes 
multithreading, then the priority value of the thread may be set. When the 
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embodiment includes single threading, then the priority value of the process may be 
set. 

[0568] The controlling service can use Virtual Reality Modeling Language (VRML), 
which uses the right-handed Cartesian Coordinate System. Accordingly, a first 
service can have a current location within the environment. Note that VRML is 
well understood in the state of art. VRML was recognized as an international 
standard (ISO/IEC- 14772- 1:1997) by the International Organization for 
Standardization (ISO) and the International Electrotechnical Commission (lEC) in 
December, 1997. Alternatively, as new industry standards for virtual modeling 
emerge, such standards could be used. 

[0569] A service can induce the effect of wind or air movement to change the 
coordinate of one or more services within the environment. The coordinate of a 
service within the environment can be maintained with the environment directory 
service. 

[0570] A service can induce the effect of heat or cold. By inducing the effect of heat 
within a given coordinate range, the service can register the current heat value with 
the controlling service, which could query the environment registry to determine 
which services would be effected by the heat, and notify the services accordingly. 
The controlling service can use multiple services to assist in controlling the 
environment. By way of example, a temperature service can be a service of the 
controlling service. When the controlling service receives notification of heat within 
a given coordinate range, the controlling service can communicate that information 
to the temperature service which then access the environment registry to determine 
the effected services. 

[0571] A service within the environment can simulate motion. In doing so, the 
service would have a velocity and a path. The service could update the current 
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coordinates with the environment registry as appropriate. In an alternative 
emhodiment, the service can maintain the current coordinates, and the controlling 
service could query the service to determine the current coordinates. 

[0572] Although alternative embodiments could languages other than VRML, 
having the standard VRML permits third parties to create services and register the 
services with the environment service. 

[0573] A consumer of the environment service can use a component of software on 
the consumer computer to connect to the environment and receive the current state 
of the environment. In such cases, the component of software may need to render 
graphic images or otherwise understand what the state of the environment, as 
communicated by the environment service, represents. In an alternative 
implementation, the component of software could access and interact with a broker 
service which understands how to interpret the state of the environment, and which 
can communicate the information to the consumer component of software in a 
manner understood by the component of software. By way of example, the broker 
service could convert the output of the environment service to a multimedia 
presentation and communicate the multimedia presentation to the consumer 
component of software. 

[0574] The implementation does not need to used the atomic level of modeling. By 
way of example, a virtual landscape such as a virtual mail, a tour, or other 
landscape could be used as well. 

[0575] The implementation could also be used for genetic sequencing, medical 
discoveries such as drug interactions, or other types of services in which one needs 
to understand the interactions between two or more entities within an environment. 



Page 119 of 229 



Marked-Up Version of Subsitute Specification 
Application 10/068,077 



[0576] Note that the environment could use ADAM, A Dynamic Attribute Manager, 
as described in Programming With UNIX Threads, C. Northrup, John Wiley and 
Sons, ISBN 0-471-13751-0, to implement mvdtithreading of services within the 
environment. A modification of ADAM as a service is defined elsewhere in this 
specification. 

[0577] Typical Embodiment 

[0578] A typical embodiment includes consumer computer, which can be a HP 
Pavilion running Windows 98, with Internet access via an Internet Service 
Provider. Internet access is t3T)ically via an analog modem for dial-up access, or via 
high-speed broadband DSL, cable or fixed wireless service. The service provider 
computer(s), which can be a workgroup class server such as a Sun Enterprise 450 
Server running the Solaris operating system, with dedicated access to the Internet 
via an Internet Service Provider. This access is typically a high-speed service such 
as Frame Relay, DS"1 or DS-3 service. The service provider computer(s) typically 
have large amounts of disk storage either internal or in external disk arrays. The 
directory service computer(s) is typically a midrange system such as a Sun 
Enterprise 3500 multiprocessor server running the Solaris operating system, 
configured with dedicated access to the Internet via an Internet Service Provider. 
This access is typically a high-speed service such as Frame Relay, DS-1 or DS-3 
service. The directory service computer(s) typically have large amounts of disk 
storage either internal or in external disk arrays. The actual computers in use will 
be determined by processing requirements. In extremely high-volume processing 
environments clusters of server computers may be used by the service provider or 
the directory service. 

[0579] Figure 1 is a diagram of a computer network communicating according to the 
present invention. A directory service computer 31 is connected to a service 
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provider computer 23 and a customer's computer 32 via the internet, represented at 
37. Figure 1 provides an illustration of such an embodiment. Note that each 
computer has at least one communication device, such as a modem or an Ethernet 
card; a monitor display such as a Pl\ilips Magnavox; an input device such as a 
keyboard; a pointing device such as a Microsoft Mouse, or other appropriate mouse 
for the configuration; an operating system, such as Linux, AIX, HP-UX, Microsoft 
Windows 98, NT, 2000, XP, or other Microsoft Windows operating system, Solaris, 
Irix, linux, Unix, BSD, Free-BSD, OS/390 or other commercially available 
operating system for the architecture. Alternatively, the operating system could be 
one provided by academia, open source, or other such operating system. 

[0580] Processing flow embodiments are provided in Figures 2-7, showing the order 
of the processing to use the invention. 

[0581] Figure 2 is a flowchart of a directory service connection service. In step 51, a 
common directory service (CDS) executes on a directory service computer (31, Fig. 
l). The common directory service maintains 52 registry SP, and listens 53 for 
communication on network endpoint. A service process executes 54 on a service 
provider computer (32, Fig. l), and then connects 55 to the common directory 
service, and sends 56 registration information to the common directory service. 
CDS creates 58 a registry entry SP-1 in registry SP and assigns a unique identifier 
SPID. The common directory service sends 62 the SPID to the service process, and 
the service process receives 63 the SPID, followed by the service process 
disconnecting 64 from communication. This results in the common directory service 
disconnecting 66 from communication. 

[0582] After the common directory service disconnects 66 from the communication, 
the service process connects 71 to the common directory service, and sends 72 
service registration information, SPID, IP address, and port (SIP) to the common 
directory service, and the common directory service receives 73 registration 
information. At this point, the common directory service creates 74 registry entry 
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SPS-1 in the service process and assigns a unique identifier (SPSID). The common 
directory service sends 76 the SPSID to service process, and the service process 
receives 77 the SPSID and disconnects 78 fi-om communication. This is followed by 
the common directory service disconnecting 79 from communication. 

[0583] When the common directory service disconnects 78 fi-om communication, the 
service process executes 81 on the common directory service and listens for 
communication on IP address and port. A consumer service executes 83 on 
consumer computer (33, Fig. 1), and connects 84 to the common directory service. 

[0584] The common directory service accepts 91 a connection by a consumer service 
requesting 92 access and interacting with SPSID, receives 94 a request and locates 
the SPSID registry entry. The common directory service receives 93 the request, 
then creates 96 a transaction registration entry and assigns a unique identifier 
(TID), and records 98 SPID, TID, and active connection information firom a 
consumer service CS in entry TID. 

[0585] The common directory service connects 101 to an IP address and port of 
SPSID, and the service process accepts 102 the connection. The common directory 
service then sends 103 the unique identifier (TID) to the service process. The 
service process receives 104 the unique identifier (TID), disconnects 105, and the 
common directory service disconnects 106. The service process connects 111 to the 
common directory service, the common directory service accepts 112 connection, and 
the service process sends 113 the unique identifier (TID) and SPID. The common 
directory service then receives 114 the unique identifier (TID) and SPID, locates 
115 the transaction entry, and connects 116 the common directory service 
connection from service process to active connection fi'om CS. 

[0586] Figure 3 is a flowchart of a directory service use. As can be seen, the common 
directory service executes 131 on the directory service computer (31, Fig. 1). The 
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common directory service maintains 132 registry service process, and listens 133 for 
communication on network endpoint. 

[0587] Figure 4 is a flowchart of a service provider registration. A service process 
(SP) executes 151 on the service provider computer (32, Fig. 1), connects 152 to the 
common directory service, and sends 153 registration information to the common 
directory service. The common directory service receives 154 registration 
information, and creates 155 registry entry SP-1 in service process and assigns the 
unique identifier (SPID). The common directory service then sends 156 SPID to 
service process. The service process receives 157 SPID, disconnects 158 firom 
communication, and the common directory service disconnects 159 fi^om 
communication. 

[0588] Figure 5 is a flowchart of a service registration. The service process connects 
171 to the common directory service, sends 172 service registration information 
SPID, IP address, and port (SIP) to the common directory service. The common 
directory service receives 173 registration information, creates 174 registry entry 
SPS-1 in registry and assigns the unique identifier (SPSID), and sends 175 SPSID 
to service process. The service process receives 176 SPSID and disconnects 177 
fi-om communication. The common directory service disconnects 178 fi-om 
communication and the service process executes 179 on the common directory 
service and listens for communication on IP address and port 

[0589] Figure 6 is a flowchart of a consumer registration. A consumer process 
executes 191 on the consumer computer (33, Fig. 1), connects 192 to the common 
directory service, and sends 193 registration information to the common directory 
service. The common directory service then receives 194 registration information, 
creates 195 registry entry CID l in service process, assigns the unique identifier 
(CID), and sends 196 the CID to consumer process. The consumer process receives 
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197 the CID and disconnects 198 from communication, and the common directory 
service disconnects 199 from communication. 

[0590] Figure 7 is a flowchart of a consumer request for service. A consumer process 
executes 221 on consumer computer (33, Fig. 1). A service request process executes 

222 on the directory service computer (31, Fig. l). The consumer process connects 

223 to the common directory service, and the common directory service accepts 224 
the connection. The consumer process then requests 225 access and interaction 
with SPSID. The common directory service receives 226 the request and locates 
SPSID registry entry, registers 227 the transaction registry entry and assigns the 
unique identifier (TID), and records 229 the SPID and TID in registry entry. The 
common directory service maintains 230 the connection with consumer process, 
connects 231 to an IP address and port of the SPSID. The service process accepts 
233 the connection and the common directory service sends 234 the unique 
identifier (TID) to the service process. The service process receives 235 the unique 
identifier (TID) and disconnects 236. The common directory service disconnects 237 
and the service process connects 238 to the service request process. The service 
request process accepts 241 the connection, and the service process sends 242 the 
TID and SPID to the service request process. The service request process then 
receives 243 the TID and SPID, locates 245 a transaction entry, and communicates 
247 communication from service request process to the common directory service 
maintained connection with consumer process. 

[0591] In a preferred embodiment, a prototype table is created containing a msg 
indicator along with a fids indicator and a description of the columns for the table. 
The prototjrpe table can also include one or more rows. The Daytona DC-red 
command can be used to generate the data dictionary information. For example, 
using "DC-red SERVICES > rcd.SERVICES" will generate the data dictionary 
information for us, without having to enter that information manually. Three 
examples of a service registries are given in Program Listings 16.1, 16.2 and 16.3, 
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respectively- The command to generate the data dictionary is shown in Program 
Listing 16.4. The resulting generated data dictionary is shown in Program Listing 
16.5. The Daytona Synop command can be used for data dictionary reporting. 
Alternatively, the backtalk command shipped with daytona can be used to generate 
data dictionary information. 

[0592] Program Listing 16.6 shows a second embodiment of the service registry 
prototype table. Using the DC-red command, the data dictionary shown in Program 
Listing 16.7 is then generated. Similarly, the embodiment of a providers registry is 
shown in Program Listing 16.8, with the generated data dictionary in Program 
Listing 16.9. An embodiment to register an entry is given in Program Listing 
16.10, while Program Listing 16.11 provides an embodiment to report registration 
entry information. The embodiment could use the Daytona Tracy command to 
process the Daytona query, which can understand either Cymbal, SQL, or a 
combination thereof. 

[0593] Note that in Program Listing 16.12, the registration request is given as a 
Daytona task (also called a function/predicate/procedure, or ^p). Semantically, the 
idea is that there is some goal that a task is intended to achieve, and the code that 
is has for doing that is free to call its own private helper tpps as well as other tasks. 
Using Daytona's Tracy command, the ^p is converted to C source code, which can 
then be compiled into object code. In normal processing, the object code is then 
linked with the appropriate Daytona runtime objects and Ubraries to generate an 
executable program. Alternatively, the object code can be linked with other 
appUcation object code to provide the fpp directly at the application level. By way of 
example, an application programmer can write their own source code which can 
then invoke the desired ^p by linking with the object code, and other Daytona 
runtime objects and libraries. In an alternative embodiment, an application process 
can use the invention to call the ^p by dynamically loading the ft)p according to the 
specification of this invention. The application service, however, will need to ensure 
that the Daytona Sizup command is executed as appropriate to maintain the 
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Dasrtona data files and indices. The use of the Daytona code synthesis (code 
generation) permits the administrative capabilities of registration, query, delete, 
modification, replication, reporting, and other such functionality as would be 
required in administering and managing the data, to be instrumented through the 
methods and systems of this specification. 

[0594] In an embodiment shown in Figure 8, the service directory would be 
horizontally partitioned. A horizontal partition divides the rows of the service 
directory (registry) horizontally based on criteria and put each group in its own file. 
The residtant individual files wiQ be easier to manage. Another benefit is that the 
physical field that would have previously been recorded in the registry can be 
eliminated, thus saving disk storage. In Figure 8, the horizontal partition is the 
category of the service. In Figure 9 the horizontal partition is based on the 
provider. In Figure 10, the horizontal partition is based on the activity. In Figxire 
11, the horizontal partition is based on the cost. In Figure 12, the horizontal 
partition is based on the protocol. In Figure 13, the horizontal partition is based on 
the entity type. 

[0595] If the underlying data management system supports horizontal partitioning, 
then such partitioning techniques could be used as well. 

[0596] The Directory Service 

[0597] The Directory Service (TDS) can administer one or more Service Directories 
(SD). In the most primitive form, a Service Directory contains one or more entries 
representing entities providing a service. Each service directory is uniquely named. 
A service directory entry is comprised of one or more Information Components (IC) 
given as name/value pairs, as depicted in Figure 14. The primitive operations for 
TDS include register, query, and delete. Additional administrative operations are 
supported, such as index, update, modify, and replicate. 
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[0598] Figure 14 illustrates a typical TDS instance. In this illustration, there are 
three service directories being maintained by a single TDS process. Figures 15 and 
16 are diagrams illustrating different implementations of TDS instances. Figure 15 
is a sample configuration for System sol27 (Solaris 2.7). Figure 16 is a sample 
configuration using multiple operating systems and different OS implementations. 
In Figure 16, three implementations of Unix, one implementation of Microsoft 
Windows and one implementation of Linux each have a TSD instance and are 
interconnected. 

[0599] Different entities provide different types of services, although a single entity 
can provide a multitude of services. A component of software, for example, can 
provide some form of a service. The term component of software is deliberately 
chosen to imply that less then an entire executable program can still provide a 
service. Examples include objects firom shared libraries, a specification for an 
interpretative language, a device, a process, and even a thread of execution. The 
operating system itself can be said to provide a service, or a multitude of services. 

[0600] A service provided by a component of software can be registered in TDS. 
When needed, a separate process can cause the service to be started. "The 
Connection Service", described in US Patent 5,850,518, describes one technique for 
registering components of a service. 

[0601] A user can provide a service. Consider, for example, the Netscape Navigator, 
or Microsoft IE. Both of these programs require a user to enter a URL in order to 
determine what to display next. Thus, the user provides input and this is 
considered a service. Similarly, an email application stores email directed towards 
a specific user. Retrieving the email is considered a service. 
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[0602] Service providers provide services, and consumers consume services. A 
consumer, however, can also provide a service. Similarly, a service can also 
consume services. 

[0603] In generalized terms, a service is facilitated by a process. For example, a 
speU checker is a process that provides a service. Similarly, a caching process can 
provide a service. The distinction of when a process is a service, and when it is a 
consumer, is relative to what the process is doing at a particular point in time. 

[0604] In the context of TDS, a process can be heavyweight, medium-weight, or 
Ughtweight. A process can consist of multiple threads of execution, including kernel 
threads. 

[0605] Each entity is referred to as a point of communication (compoint). To 
facilitate the method, each compoint can participate in a commxmication with 
another compoint. A compoint can either send a communication, receive a 
communication, or both send and receive commimications. A commimication can be 
sent as messages, data, and streams. 

[0606] The generaUzation of services permits a single TDS to administer multiple 
service directories. This provides maximum flexibility in organizing service entries. 
Note, however, that multiple TDS processes can execute on the same system. 
Furthermore, remote TDS processes can broadcast their availability and this will 
cause the local TDS to register the remote as an entity providing a service. 

[0607] In a typical environment, a system wide TDS is available as a compoint. The 
system wide TDS provides a default service directory for a specific system. Be 
careful not to confuse the term system wide with network wide, or corporate wide. 
The term system wide simply means a TDS that is executing on a single computer 
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and is available to any compoint executing on that computer. The system wide TDS 
is also available for remote processes. 

[0608] All request received that do not specify a particular service directory, will be 
executed against the default service directory. The default service directory 
contains one or more service type entries. Each entry is composed of one or more IC 
pairs (name/value pairs). 

[0609] The system wide TDS can maintain multiple service directories. This 
permits the grouping of common service entries into a service directory dedicated to 
the service type. Each service directory has a unique identifier. 

[0610] An example TDS is shown in figure TDS-2 for a system called sol27. In this 
example, TDS maintains a default service directory, an application services service 
directory, and a process service directory. 

[0611] When TDS is started, it will broadcast its availability. This permits a TDS 
on one system to share information with a TDS on a second system. When a local 
TDS receives a broadcast fi:om a remote TDS, the local TDS wiU query the remote 
TDS to learn its registered characteristics. As long as the characteristics can be 
determined, the local TDS will register the remote TDS in the local TDS*s default 
service directory, as an entity providing a service. 

[0612] An environment with 5 systems, each running their own TDS and sharing 
information is shown in figiure TDS- 3. Each of the TDS process's broadcast their 
availability. 

[0613] Each service directory has a record-class-description (red) defining the IC 
pairs for the service type entry. Record class descriptions are described in more 
detail in section 2.2 and 2.3 of this document. 
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[0614] A service entry consists of multiple IC pairs. The service entry has an 
assigned the unique identifier. Each IC pair consists of a name and a value. The 
grammar is given as' 

[0615] service type entry • id name=value [name=value] ... [name=value] 

[0616] A value can contain white space provided it is quoted. The following 
examples show various name / value pairs. 

[0617]tds=default 

[0618]tds="system wide service directory" 
[0619]tds=*appUcation specific service directory' 

[0620] All entries within a given service directory must be unique. Uniqueness, 
however, can be a single IC pair. Thus, the following are considered unique entries^ 

[0621] name=tds physical=Aocal7usr/lib/share/TDS/tds_compoint 
[0622] name=tds physical=sol28:9998 
[0623]name=tds physical=sol28:i27.0.0.i:998 

[0624] An IC name has attributes describing its use. A private attribute, for 
example, instructs TDS not to report the IC pair in a query operation.. The defaxilt 
public attribute, however, indicates that the IC pair is to be reported in query 
operations. Note that a query operation can use the IC name value pair as part of 
the criteria for selecting the entry, but TDS wiU not include that IC pair in the 
query response. A service directory can also be marked as private, and thus the 
name of the service directory will not appear in the results of query operations. 

[0625] When a first red is replaced with a second red, the operation can specify a 
load map to map the existing entries according to the new red. 
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[0626] TDS permits IC pairs to be prefixed with their corresponding service 
directory identifier. For example, a query command can reference the name IC from 
the suppliers service directory and the name IC from the products service directory 
by specifying: 

[0627] query supplier. name="GTL.*" product.name=*" 

[0628] A record class description (red) defines the characteristics of the IC pairs for a 
given service directory. Each service directory has a red.. The red defines the IC 
pairs and their data representation. An example red is given as^ 

[0629] command=rcd \ 
[0630] sd="appIications" \ 
[063 1] service_name=str (50) \ 
[0632] regi8tration_date=yymmdd \ 
[0633]value=float \ 
[0634]count=int \ 
[0635]flag=short \ 
[0636] provider=8tr(*) 

[0637] To impose a red, an administrative process must register the red with TDS 
when the service directory is created. Alternatively, a default red can be identified 
through the configuration file. A red can be inherited from a parent Service 
Directory. 

[0638] When a process registers a service with TDS, then TDS wiU search for an 
applicable red and wiU invoke the corresponding red function. Similarly, when the 
process queries TDS for an accessible service, TDS will search for an applicable red 
and will invoke the corresponding red function. 
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[0639] When a service directory is referenced without an existing red, then TDS 
simply adds the IC pairs are necessary, to the service directory. As an example, the 
following register command will create the service directory process, and add the 
pid and md IC pairs. 

[0640]command=register sd=process pid=19452 uid=12345 

[0641] This makes TDS lightweight enough for even the simplest of applications. Of 
course, once a service directory has been created in this fashion, you cannot add a 
record class description without applying some form of conversion. 

[0642] It may be inappropriate to use TDS in this manner for production 
environments, as there is no provision for vahdating the registration. Using a 
record class description, however, will Umit registration requests to only those IC 
pairs defined in the record class description. Additionally, indexing and data 
management is much more robust when a record class description is defined. 

[0643] The primitive operations for TDS include register, query, and delete. Several 
additional operations are provided for administrative support. Each request to TDS 
includes a command, and one or more IC pairs, given as parameters. Examples 
include 

[0644]command=register name=tds physical=/local7usr/TDS/tds_compoint 
[0645]command=register name=tds physical=sol28: 127.0.0. 1:998 
[0646]command=query name="*" action=match 
[0647]command=query name="this is a string" action=casecmp 

[0648] Note that for query command, there is an implied AND operator between the 
IC pairs. Explicit Boolean operators are also supported. Support for Boolean 
operators is dependent on the red implementation. 
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[0649] The query operation will report all public IC pairs for the registered service. 
To hmit the scope of the report, a special action IC pair can be used. Assigning a 
value of match to the action will cause query to report only those IC pairs specified 
as parameters to the query operation.. The special value of for an IC pair, 
indicates to match anything.. Thus, the query operation below will report the all 
entries having a name=Jane and having an email IC component. 
[0650] query name="Jane" email="*" action=match 

[0651] Multiple action IC pairs can be specified. Valid actions include^ 

[0652] strcasecmp ignore case when comparing 

[0653] numericcmp use a numeric comparison instead of a ASCII comparison 

[0654] The query command supports regular expression pattern matching.. The 
following query will match on aU entries with a name IC pair wherein the value 
starts with the letter J. 

[0655] query name="J*" email-'*" action=match 

[0656] When using a query command against a single service directory, you can 
specify the service directory name with a sd parameter given as an IC pair. When 
using a query command to query multiple service directories, you can prefix the IC 
pair name with the name of the applicable service directory. Consider for example a 
service directory identified as suppliers, and a service directory identified as 
products.. The following queries are acceptable through TDS. 

[0657]command=query 8d=supplier8 name="Global Tech.*" 
[0658]command=query supplier8.name="Global Tech.*" products.name^uwin 
[0659] command=query products.name=uwin 
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[0660] The first registration command, given below, creates a new service entry in 
the service directory.. The second registration command adds the IC pair 
primitive=INET to that entry. 

[066l]command=register name=td8 physical=sol28:9998 
[0662]command=register name=tds physical==sol28:9998 primitive=INET 

[0663] Using the register command, a process can register a NULL value for an IC 
pair, thus eliminating it from the service directory.. The service directory does not 
retain any NULL valued IC pairs. Consider, as an example, the following^ 

[0664]coxnmand=regi8ter name=tds physical=8ol28:9998 pid=1956 
[0665]command=regi8ter name=tds physical=8ol28:9998 pid= 

[0666] In this example, the first operation creates a service directory entry with 
name=tds physical=sol28-9998, and pid=1956.. The second operation then assigns a 
NULL value to pid, and thus pid is removed from the entry. (TDS silently discards 
NULL value IC pairs). 

[0667] TDS supports the Cymbal 4th generation language in command statements.. 
The format is- 

[0668]command=DS spec=specification 

[0669] TDS provides administrative services for authentication and communication 
encryption. Administrative services are dynamically re-configurable, and provide 
sufficient flexibiUty to meet most needs. 

[0670] The authentication service provides for authentication of requesting 
processes.. The unscramble service provides unscrambHng (decryption) of 
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communicated data, and the scramble service offers scrambling (encrsrption) of 
communicated responses. 

[0671] Administrative services can be registered for a particular service directory, 
and default to administrative services registered for the system wide service 
directory. Administrative services can be limited to particular primitives, such as 
the register primitive, or, registered for all primitives. 

[0672] To register an administrative service for a service directory, you must specify 
the service and the service directory to which it applies. For example- 

[0673]command=register 8ervice=authentication \ 

[0674] 8d=default name=default_logging location=lib8ervices.so.l.O phy8ical=- 

[0675] To register an administrative service for a particular primitive within a 
service directory, you would specify the primitive, the service, and the service 
directory. For example : 

[0676]command=register primitive=register service=authentication \ 
[0677] 8d=default name=de£ault_logging location=libservice8.8o.l.O phy8ical=- 

[0678] Registered administrative services are retained by TDS through the backed 
data management system. 

[0679] Note that the user id of the process that started TDS can replace or otherwise 
alter the registered administrative services.. Thus, the user id becomes the 
administrator of TDS. 

[0680] The authentication service, if registered, is provided with connection 
information indicating the system from which the requesting process originates. 
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and possibly the process identifier.. The authentication service provides a status 
result, which if zero, indicates that authentication is successful. Otherwise, 
authentication fails and the connection is closed. 

[0681] The unscramble service, if registered, is provided with the content.. The 
unscramble service will unscramble the content and provide a response which is 
then used for subsequent operations. As impUed, the entire message received by 
TDS cannot be scrambled.. The reason is that TDS must be able to ascertain the 
service directory component, and possibly the command component IC pairs in 
order to determine the appropriate unscramble service. 

[0682] The scramble service, if registered, is provided with the response 
communication.. The service will scramble the content, and provide the response to 
TDS, which then makes it available to the requesting process. 

[0683] TDS can be started firom /etc/rc services, or, by any application having 
appropriate privilege.. The first call to TDS will create a defardt system wide 
service directory for general registration.. The system wide SD can be disabled by 
changing the systemSD=default to systemSD=none, in the TDS configuration file. 
See the section Configuring TDS for more details. 

[0684] TDS is configured to recognize and process a set of commands. Nonetheless, 
a process can register new commands, alter existing commands, and change the 
behavior of commands. A command is sent to TDS as a name / value pair, with one 
or more parameters given as IC pairs. Note that IC pairs command=value and 
tds=value are non-alterable and processed by TDS.. The remainder of the IC pairs 
are given as parameters to the service corresponding to the command. TDS uses 
the tds=value IC component to select the appropriate registry service directory. 
Once located, the register service is called with a reference to the service directory, 
and the remainder of the IC pairs given as parameters. 
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[0685] command==register 

[tds=service directory] 
[name=value] 

[0686] command=query 

[tds=service directory] 
[name=value] 

[0687] coinmand=delete 

■ [tds=service directory] 

■ [name=value] 

[0688] command=register 
rcd=rcd 

■ [tds=service directory] 
[location=rcd service location] 

■ [physical=physical connectivity] 

- [inheritence=on I o£fl 

[0689] command=delete 

- rcd=rcd_name 

■ tds=service directory 



[0690] TDS provides a registration feature for service such that the administrator of 
the service directory can register alternative primitive commands.. This includes 
the register, query, and delete primitives. In registering an alternative command, 
TDS wiQ change to the owner user identifier during the request.. Thus, if TDS is 
started by a first user id, and an authorized process registers an alternative query 
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command, then TDS will set the effective user id to the authorized process user id 
prior to executing the command.. This option can be disabled through the TDS 
configiiration file. 

[0691] TDS also permits registration of additional primitives beyond the standard 
TDS primitives. When TDS receives a command, it wiU look-up the command 
name, and execute the specified registered command. To ensure security, however, 
TDS will temporarily switch to the specified user id when executing the specified 
command.. This option can be disabled through the TDS configuration file. 

[0692] In our network, we provide a supplier service directory and an applications 
service directory as the default directory services offered through TDS.. The 
supplier service directory records all suppliers of services while the applications 
service directory records available application services.. The record class 
descriptions are given as^ 

[0693]rcd=Supplier sd=SuppUers 
[0694] Name=string(50) Address=string(50) 
[0695] State=string(3) Zip=string(lO) 
[0696] Phone=string(lO) Id=string(15) 

[0697]rcd=Applications sd=Applications 

[0698]Name=string(20) Location=string(256) Physical=string(25) 
[0699] Primitive=string(lO) System=string(l5) Release=string(5) 
[0700] Os=string(15) Description=string(250) ld=string(l5) 

[0701] The following services are then registered on the sol27 system. 

[0702] command=register sd=Suppliers 

[0703]Name="GTL Inc" Address="15 Spring St" City=Princeton State=NJ 



City=string(20) 

Contact=string(20) 
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[0704] Zip=08542 Contact=8ales Phone=(609)924-7305 

[0705]Id=123456789 

[0706] command=register sd=Applications 

[0707] Id=123456789 Name=queued Location=services 

[0708] Phy sical=sol27 :9990 Primitive=inet Sy8tem=sol27 
[0709]O8=solaris Description="queue service" 

[0710] For our winntsp6 system, we register^ 

[071l]command=register sd=Suppliers 

[0712]Name="GTL Inc" Address="15 Spring St" City=Princeton State=NJ 

[0713] Zip=08542 Contact=sales 
[0714] Phone=(609)924-7305 Id=123456789 

[0715] command=register sd=Applications 

[0716] Id=123456789 Name=url_j)e Location=services 

[0717] Physical=*:* Primitive=inet System=winntsp6 

[0718]Os="Windows NT" Description="URL Processing Element" 

[0719] Similarly, for the redhatO.l system we register : 

[0720]command=register sd=Suppliers 

[072l]Name="GTL Inc" Address="15 Spring St" City=Princeton State=NJ 
[0722]Zip=08542 Contact=sales Phone=(609)924-7305 

[0723]Id=123456789 

[0724]command=regi8ter sd=Applications 

[0725] Supplierid=123456789 Name=url jpe Location=8ervices 
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[0726] Physical=*:* Primitive=inet System=winntsp6 
[0727] Os="Red Hat Linxw" De8cription="URL Processing Element" 

[0728] Once the service entries have been registered, our red functions record the 
entries into indexed files for subsequent retrieval. 

[0729] On the sol27 system, we execute a urld process.. This process fetches an 
HTML page from the Internet, and stores that page on the local system. 

[0730] The urld process will query TDS to locate an available urljae service to 
process the fetched page. 

[073l]PrQgrQm Lioting 1.1 Source Code Lioting of One Implementation for the 
Roplaoomcnt rccv Function 



a.^inoludo ^ - oyo/tyTjco.h?^ 
8,#inoludo '^oyo/oookot.h"* 
4 , # inoludo "ocrvdoco.h" 
S-tfinoludo " 3 d.h" 

S .otruct hootont * gcthootbynamc(oonot chor ^noa ae) 

8 .otruct hootcnt *h - (otmct hootcnt ^) _gothootbynQino(namc) ; 

|0?33]«: — { 

[0733]umi 

T^op - mQlloo(400 6 ): 
[0735]ldQ_qucr>^^(Gp,ncuiiG, 100 6 ); 

[O 7 36] iao^ct_nlpp(op,>JULL.>njLL, & phyoioal.>aJLL,NULL): 

[0737]4 4: if(phyoioaD ( 

T^oci^aoo, ^oomputcrl 
[O 73Q]ocr>aoo-~computcr~phyoioQ ^; 
t0740]whilc(^OGn t Tioo && T^ocr^'ioo !- ' ') t « ocrvaoQl 

[0741k 

3tum( (otmct hootcnt ^) ^othootbynQmcdmmo) ); 

rfi7ii_^ii 
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[0744]» 
[0746]ife te«^ 



[0747]ProgrQm Lioting 3-0 Engine Sorvioo ongino.c 
[0748]v^ 

[0760]^ 

[O 76 1] tfinoludo 'ifontl.h'^ 
[0763]//mcludo ^dlfon.h-> 
[0753]//inGludc 'Uiniotd.h-* 
[0754]//includo '^otdUb.h-^ 
[0766]//inoludo '-lomio.h-^ 
[0766]otQtio int (^otartup)(int, ohop void ^ 
(^ohutdownXvoid): 

\ff1b9\mmfmiMfmmmuwmmmmmwummunmummmm 

[07681 ;^ tho ongino oompononto, in tho order oollod [if dofinod] 

a»^^ 

proprooooo 

^eeess 

[0764]^ 



rooponoo 



[0767]otQtio int (*Quthoriiio)(iiit, choj ^ void **)^ 
[0768]otatio int (ffinput)Gnt, ohor void ^*); 
[0769]otmi cj im b (^pPopgooooo)Gnt, ohor void 
[0770]otQtio int (*prooooo)(int, ohor *. void ^*) ; 
[077l]otatio int ('^pootpPOOCOo)ftnt, ohoj void **); 
[0772](iiuUo int (*rooponoc)(int, ohcu ^. void 
[0773]uictom char ^gctnvpaiKchap ohor ohor **); 
[O 7 7 4]oirtom int roadlino(int,oh£U' *,int)l 
[0775] u tmiiu int 

[0776]oonfiguJO_onginoGnt fdi ohor *Qrgo, void **handk ) 

[0777]< 
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[0779].uui 

bufifcr[PIPE3 y¥^ 

[078 l]t gotonvCENGn^JE.COJFIG")! 
[0782]i£( uuoooo(o,Bl.OK) — 0) f-ol 
[0783]fd opon(tO-RDO>JLY); 

[078d]if( fd ^ 0 ) ( ^rintf(otdoCT>"fQilod to open oonfig filo [^o]\n", f)l roturnC ' l); ) 

[0786] wliUc( roadlino(fd,buffcr,PIPE,BUF) ) ( 
-efe aj *oolnponcnt-^JULL; 
^ehor *pamo~NUIjL: 
■■e hoj ^looation-NULL f 
■ char ^cp-bxifforl 
■ whilc( *cp ) { 

■ ohop *n->fULL, *v->rULL; 
■ cp~gotmi)air(Qp, & n, & v )i 
■ if(!n I 1 !v)broali; 

■ if(otjomp(n«"oompouuiii'') 0) oomponont~vi 
■ gIoc if(otrGmp(n,"namc") — 0) naino =v; 
■ oloc if(otromp(n,"looation'*) — 0) loootion-v; 
4 

■ if( name & & location ft& oompononii ) { 
■void *h->aJLLl 

■ int (*0(int,char ^,void ^*)->njLL; 

■ h-dlopon(looQtion, RTLD_JiAZY); 

■ if(!h) oontinuQ; 

■ f"dbym(h.ntun e); 

■ if(!£ > ( dlcloocCh)? oontinuol ) 

■ if( otrcmp(ooniponont,"Quthonticatc") — 0) authoinBO'"fi 

■ oloc if(otrcmp(oomponont, "input") — 0) input~fi 

■ cloc if(otrcinp(oomponont,"proprooooo") — 0) prcproocoo-f 

■ cloo if(otrcmp(oomponont,''prooooo") — 0) proocoo^ 

■ oloo if(otjoinp(ooinponont."pootpi 'oe uo u ") 0) pootpi'ooGoo~fi 

if(otroinp(ooinponont,"rcoponou'0 0) raopoD£)C~fi 

■ oloo if(ot Jomp(oomponont, "otartup")^= Q) otartup-fi 

■ oloc if(oti«cmp(Gomponont,''ohutdown") — 0) ohutdown-il 

■ oloc dlolooo(h)l 

4 

[0788]a out (fj); 

[0789] iL Oum(0); 
i\i f tj -t-jv 

[0793] int onginoGnt fd, void ^orgo) 

[0706]iiiiio 1; 
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I initioliBod ) ( 

[07Q7]iiiitiuliBod-ooiifigujo^ongino(fd, argo. handlo); 

■ if( otortup ) otQrtup(fd,Qrgo, & hQndlo); 
■ if( ofautdown ) Qt03iit(ohutdown)) 

QuthoriBC & & (ro~authoriao(fd>Qrgo, & hQndlo))) goto rooponocj 
input & & (ro~input(fd,Qrgo, & handlc))) goto rooponooi 
ppGproccoo & & (ro-proproocoD(fd, orgo, fe hondlo))) goto rooponool 
proocoo & & (ro-proocoo(fd,Qrgo, & hQndlo))) goto rcoponoo ; 

[0803k pootprooooD & & (ro-poPtppoocoo(fd,(irgo, & hQndlc))) goto rcoponfloi 

[080 dli ' OOponQO' 

{086^ Fcopoimo ) rcoponDQ(fd,argo,(void **)ro^i 

roaOfil.Lnmrny 

{080?% 

[0808]ProgrQm Lioting 2.1 Engine Sorvioo gotnvpair.o 

[0809]mmwm/miiiimiimmimmmmiiiii 

— given an input otring, return the ncjtt iiQmo~v^Qluc po M? 
— the value of name io returned in the location pointed to by name, 
— and the value io rctumod at the location pointed to by voluo. 
[0813]# RETURN . 

[0814]^ namo hao a pointer to the name oomponcnt, which io null 



Lueioj# 

(084€}# 


terminated, thio io an inline rcplaoement, oo 

thio moano that the otring pointed to by op io 


[0817]# 

iOSiSAu 


is modifiod. 

value hao a pointer to the value component, which io 


{084^# 


null terminated, thio io an inline roplaocmont. 



'" ■ oyo/t>T)00«h> 
t0833]#iJiuludc *^ ' Otdio.h> 
[0834] u lim* 

[0836]|{uto»|iuu( ohM *ep) ehn» **iiainoi oha» **¥ttlue) 

{083^ 

[0827]kit - uQO_quoto-0; 

! op ) roturnOlULL); 

[0839]if( »op — T ) gotuma>ajLUi 
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fhilai ioopQOc(^cp)) > i cp: 



yhilo( T^op & & *op !- * « op; 

[0833k ){ 

■ ^^cp-'\0': 
■ lvalue ~ ** GpI 

'if( ^i^valuo — "") uoo.quoto-""; 

^%^q1uo — '\") uoo.quoto-'^ 
■ ifC uoo_quotc ) { 4i* opI i^valuo~cp; ) 



■ if( uoo_quoto && *op — uoo_quoto) 

{08»at *op - '^lO'; »* Gp; brook; ) 

■ cbc if(!uoo_quotc & & ioopaoo(^cp)) brook; 



4 

■ if( ioopaoo(*op)) ( 1*op-'^^0'; i i cpl ) 

1083^ 

[0836]i ' otum ( op); 

^839^ 



[0 8 3 8 ]Program Lioting 3.3 Engino Sorvioo authorigo.o 

[0840]int QuthorigoGnt fd, chor ^ojgo. void **hQncilc) 
[084l]{iaum(0);) 

[0843]ProgrQm Lioting 2,3 Engino Sorvioo input.c 

[0843]//mUua. - u tdi u .h> 

[0844]iiit inputdnt fd. ohar ^"^argo, void **httndlo > 
[0845](i ' ttmii(0);) 

[0846]ProgrQm Lioting 3.4 Engino Sorvioo pootprooooo,c 

[0847] tfinoludo ^otdio-h^ 

[08 48]int pootpPOOoooGnt fd, chnr ^orgo, void *f^handlo) 
[0849]{rcturn(0);} 

[0860]ProgrQm Lioting 3.5 Engino Sorvioo proprooooo.o 

[085l]//liioludo ^ - otdiorh^ 

[0863]int prcproocooftnt fd, char *Qrgo, void ^^hondlo) 
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[0863]{roturn(0)l} 

[086 4 ]ProgrQm Listing 2.6 Engino Sorvioo prooooo.G 

[0866]mt proooQoGnt fd, chap ^argo, void ^^handlo) 



[0857]ProgrQm Lioting 2,7 Engino Sorvioo rooponoo.c 

Fooponoc(int fd, char ^^apgo, void **hand l^ 

[0869]uaum(Q);} 

[0860]ProgrQm Lioting 2,8 Engino Sor\doo roadlino.o 

[086l]//inoludc ^<iot.h^ 
[0 8 62]//muludu ^tdio.h^ 
[0863]//inoludo ^ofio.h^ 
[0864]//moliido '-h nn h 
[086 6] //include «^mcmory.h?^ 
[0866]//iiicludo '-ormo.h^ 

[0868] i tadliu u (mL ■ fd, char ^bufFor, oiBC_t Ion) 

{086^ 

[0 8 70li JiHae=t H5-»eJ 

[087l]dim u -Q. oldc, *ptp; 

— *in_j)tir-buffoiS 

[0873]mt| , ; 

[087 4]iimmmimMmiiiimmmiimmi 

[0 8 76]# — tiy tho foot way firotj uoing pcohL.c, wo can oco 

— if thoro io a now ■ lino in tho input otJoam rftBd 
g can road up through tho ncwlino. 

^d^^mmmmmmmmmmmmmmm 

[0879W 

^88^4^ 

^ muummumimmmimuumumiw 

41 wait fog up to 8 0 occondo for oomothing to 

*U — bo readable 

mmmmmmmmmmumuumumfm 

■ waitjoad(fd, 3 0)l 

_o(fd,'^.n'); 
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' Uummmmmmmmmmmifmm 

^ if thio io intogaotivc, then pccli_c will foil 

with ' 1 booQuoo we Gonnot peck on a tty . 

••^Z Infltcad, wc have to break out of thio loop, and 

*U — read ono byte at a tim er 
'U 

'U — NOTE* wo really ohould bo tooting to oco if thio 
'U io a tty, or not. 

^ mmummmimmmfummwummm 

■ if( p < Q ) break; 
■ if(p && p < Ion) { 



f i ' oud(fd^injptr>p * l); 
'if (r^"3) { 



3.if((bu£fop[ya]— 'W) && 03uffoglg'l]— ^lO')) 

4.in_ptr-in_ptr * g; 
5.0I00 breali; 

4 

■ eloo ifd i' ^O) ( 

l.if( buffor[r' ij— '^^n') bufferlr* l]-'\(y] n-r i; break; ) 
■ eloo if(r — 0) gotupn(n); 
4 

■ ilXp 0) break; 



{688214 

[0883] u iJ c 0; 

[0884] pu b uff .. : 
[0886]rui(u i:. i ^ len; n *.4- ) ( 



■ if( (ro-TCQdCfd^&o. D) — 1 ) ( 
. ^ptr - c; 



■ if(o — '\n'){ 

l.ifColdo — '^i^i' ) { "ptr; "ptr; continue; } 



4 

■ ) oloo if(ro- OXiftu 1) rotugn(0); oloc break; ) 
[0886W { if( errno — EINTR ) goto again; rotum( ' 1); ) 

(088^ 
[0 88 8]^pu o; 

[0889]rclm ' n(n); 
fnQQflli 
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[089l]ProgrQm Lioting 2.9 Engino Sorvioo wQit„roQd.o 

[0893]//iiicludo <otdio.h-^ 
[0893]//moludo '^otdlib.h-^ 



[0894]//inoludo ^oyo/ocloot.h^* 
[0896]tfiuuludu ''■oyo/timo.h"* 

[0896li>iiiuiudu 



fnQQQi. 

odt joad(int fd, int ti aeeat) 

[090l]cu.ut voadjbi orror_fb) 
— nfdo, g; 
odTninfd"'!; 
[0904]mi ' u c t timovolt; 

(^fiuiotioii)(void) - NULL: 

[0906lu[i01U0Cti( ft t, ">iO*, oi e oofOitruot timovaD); 
[0907]fD_ZERO( A road^fo ); 

(Q9Q ^fd_zebo( 
[0009]rDjGCT( fdt & roQd_fo ); 



[091 IL 

[0912].iiii t (i) 
^91^ 



't.tv_ooo ~ timeout; 

'ir-ocloot(nfdo,&roQd_fo,NULL, & cinror_fb, & t); 
«if( r ^ 0 ) i'ctum( ■ 1 )) 
' Oloo ift p — 0 ) poturn( 0 )l 

■ olocif(FD_IS S ET(fd,&road,fb) I I FDJSSET(fd. & OCTOg_fo)) 
'POtum(fd); 



■ doc if( Qdminfd !- ■ !& & FD_I S SET(Qdininfd, A voadjb)) 
■ roturn(adminfd); 

[091 4]» 

[0916]in,uiu(fJ): 

^91^ 

[0917]ProgrQm Lioting 2.10 Engino Sorvioo - pook.c 

[0919]*iii i) lud(a r;oyo/i eeaA»' 
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[0930]tfinoludo ^ ■ oimo.h^ 
[0922]p tj cli(m«,fj) 

[0934]iin,u o; 

[0926]if( ioctlCfd. FIO>ntEAD, A n) !- 0) { 

■ Q)rintf(otdorg,'*ioctl fd-[^d] failed or^no-1 6 d^ln^ fd, ogmo): 
■ rctum( ' l); 

[0937Le%m^ 



[0839]Program Lioting 3.11 Engine Sorvioo pook_o.o 

ftncludo ^o^ ■ ^ ■ no.h^ 
[093l]//inoludo ^otdio.h> 

[0932]//maudL 
[003 

[0936]//inolndo '^8y(Vooeliot.h> 

4093^ 
[0937], 
{093^ 

[OOlOliiiiu i; 
[OOllliuiiL i: 

[0943L 

{694^e 

[0941]. 

[0946]iJ( iocdtfd, FIONREAD, A n) 1^ 0) ( 

■ ft)riiitf((itdoCTi"ioi»tl H^IWd] failed ei ' tiio'tid^ m"! fdi wno): 

■ W)tUHl( ' l)i 

{0946}} 

{Q94? }if( n — 0 ) rotum( - D; 

[0948]ir(u- buiiic)! 

■ifCbuffor) frooObuffor); 
■ buflbi ' mallooCnU); 

{0949]} 
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[0960]mcinoot(buffcr/^iO'»boi B o); 

[096 l]m -roov(fd.buffbr,n.MSG JEEK I RC S G JJONTWAIT); 

[0063]ir(io = 

[0966]Program Lioting 3.13 Engine Sorvioo ma khe 
[0957]4 Bt 

mindnt orgo, ohor ^arg^^D) 

[0960]Lm } un-(o,i i iULL); 

[0963]PrQgrQm Lioting 2.13 Engine Sorvioo - MakofQo 

[0964]:PACKi\GE aot 

[0965]cFLx\GS - ■ D_BLD_QOt $(CC.DLL) - WoU 

[0966luut j um :lJBRi\RY' ongino.o poadlino.o gotnvpQip.o waitjroad.o pcok.o pooli,o-o 'Idl 

[0967]Program Lioting 2.14 Engine Sorvioo - ongino.mk 

[0968]:rACI^\GE' ongino aot dl 



[0970]ProgrQm Lioting 2.16 Engine Sorvioo • dummy. mk 

[0971] PACKAGE QOt 

[0972]cFLi\G S - ■ DJLD,QOt $(CC.DL) ' WqU 

[0973lduuimy iUBRARY^ authogiHO.o input.o pootppooooo.o pgoppoocoo,o pgooooo.o gooponiXi.o 

[0974]ProgrQm Lioting 3.16 Engine Sorvioo - ongino.oonf 

[0976]oomponont~authontioato namo-Quthontioato looation-'.7authontioato/libQuthontioato.oo. 1.0 
[0976]uoniponont-input namo-input looation-yiibdummy. ^ertrO 

nponont-ppop'ooooo no in o-pgoprooooo looation-./libdummy.oo.l. -0 
[0978]oomponciit-prooooo namo-prooooo looation^.flibduinmy.oo. 1,0 
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[0979] uo mponont-pootiprooooo noino-pootppooooo looation-./libdummy.oo.l.O 
[0880] uu mpmtentni€0ponflo iiQmo~rooponoo looation-./libdummy teerjbO 

[OOSllProgram Lioting 3.17 Engino Sorvioo - onginoS.o 

[0982] int - onginoGnt fd, void ^argo) 

fftQQKl 

L w %J \J J-Si 

[0986]uonfiguro_ongino(fd, orgo, handlc)l 

[0989]if( otortup ) otartup(fii,Qrgo, & h aBdte)f 
[0990]if( ohutdown ) atoxitCohutdow fl^ 

ohutdown ) 

[0993]iiiitialiBod-i; 

Quthoriao && (po~"Quthoriao(fd,Qrgo, & hQndlc))) goto pooponoci 
input ftft (iKr-input(fd,aggo, ft handlo))) goto gcoponool 
pjcpgooooo & & (po-pjopi'oooootfd, orgo, fehondlo))) goto rooponoo; 
I && (ro~prooooptfd,Qi ! go,&hQndlc))) goto rooponoo j 

[0998]if( p o utpi ' ooooo && (ro-pootpgOGOoo(fd,QJgo, & himdlo))) goto rooponoo; 

{O^^^^^^ roupoiiuu ■ 

{186^ rooponoo ) TOOponoo(fd>aggQ,(void *tt)ro)l 
[lOOl] i tlum(0)l 

[1002]} 



[l003]ProgrQm Lioting 2.18 Engino Sorvico - onginoS.o 

[l00d]//inoludo ^ ^ QOt.h^#moludo ^ofio.h>#includc ^ ■ otdio.h>#includG ^fcntl.hi^#inoludo <dlfcn.h?^#includo '" ■ umotd.h^>#inoludo 
*^tdlib.h?^inoludo ^cgi ' no.h' otguot _oompononto (int (*funotion)Gnt, ohor void otruot _oompononto — *noKt; 

puct _oonipononto — *laot; 

t .ongino ( 
aot .oompononto *hoad; 
^[l99^^8tp uot .oompononto *toil; 

jb _cngino onginopojtol 



Page 150 of 229 



Marked-Up Version of Subsitute Specification 
Application 10/068,077 



int (*^otiartiup)(inti ohop *, void ^^Yi 
i (*ohutdown)(void)l 

int (*authoriao)(int, ohor void 
[l016]utatio int (T^input)ttnt, ohor \ void **); 
[10161 i tatio int (*pgoproocoo)(int, ohor void 
I tatio int (*pgooooo)(int, ohoj *, void ^*); 
[lO ISjuUitiC 1 int (*pootprooooo)(int, ohop void 
[l019]otatio int (*rooponoG)(int, ohor *, void 
U03^««teP» chog ^eotnvpoijCGhQj ^, char ehaiv*^) ^ 
[102 l]cstcm int roadlino(int,char * int); 
[l 022]jt ruct co mponcnto* 

[l033]i\U o UAtL(. u id) 

[1034]4 

Bt ,oomponcnta ^oomponcnti 
[l026]ooinponeut malIoo(QiBOof(otruct joomponcnto)); 
[l027]if( oomponont ) mcmoct(coinponont,'^iO',oiBoof(otruct _oompononto)); 

! onginopartQ.hoad ) { 

a. ongincparto.hcad~componontl 

b. oncinoparto.tail~ooinponontl 

[1030W( 

Q.Qomponont'^ ' lQOt - cnginoparto.toil; 
b.cnginoparto.tail ' -'>noKt~componont; 
o.cngincparto.tail~oomponont; 

[I03lt 

[l032]i ' utum(oomponcnt)l 

anfiguf o_ongino(int fd, char ^argo, void ^^handlc) 

[1037W *^ 

[I088]uiuu — *f^ongino 



[I039]tlim bufiFcr[PIPE_BUF]l 

[1040]l brctcnv("ENCI>ffi_CONFIG")l 
[I04l]if( aoocoo(c.R.OIO — 0) f-o: 
[I042]f j opon(f,0_RDO>JLY); 

[1043k fj o){ 

a. f i printf(otdorg,"£ailod to open oonfig filo [^ol'^in", f): 

b. rotum('l): 
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[I04ll» 

[l046]wliilo( i'CQ(Uino(fd,bu£fcg,PIPEJUF) ) ( 

Q.Ghar ^oomponcnt~>JULLi 
b.Ghor T^nQmc->ft flA; 
cohor Mooation'">fT.TT i T i i 
d.ohar ^^op^buffop; 
G.whilc( *op ) { 
fohor *n->JULL. *v-}} m^ 

g. op-gotnvpQir(cp, & n, ft v ) ; 

h. if(!n I I !v)bi«OQli: 

iM otrompdi/'componcnt") — 0) componont-vi 
j.cloo if(otigcmp(n,"nQmo") — 0) nomo-vl 
k.cloo if(otgomp(n. "location") — 0) looation-vl 

m.if( name && location && componont ) { 

n.void ^h-NULL; 

o.Qtruct _compononto ^parti 



p.int (*0(int,ohar *,void i'^^)->njLL; 

q.h-dlopondocation, RTLD.LAZY); 

p.i{(!h) oontinuol 

o.f-dlosTn(h,nflmc); 

t.if(!0 { dlolooc(b); continue; } 

u. lf(otrcmp(oomponcnt,"otagtup") — 0) otartup^ 

v.oloo if(otrcmp(oomponcnt,"ohutdown") — 0) ohutdown~fi 

w.cloo ( part-AIlocatoOi part ' >fanction-C ) 

[1048]. 

[l060]otatio int initialigo d^ 
[106 l]otatic void ^handloi 

) onginoaftnt fd, void ^orgo) 

[l06d]uU ' iiut _oompononto *0 ( 



! initioIiao d-M 

Q.ijiitiQliBcd~Gonfiguro_onginG(fd, orgo, handle)? 
b.if( otartup ) otartup(fd,argo,&handIo)l 
o.if( ohutdown ) QtoKit(ohutdown); 

[l06 7]uomponont~onginoparto.hoad] 

[l068lwhilo( oomponont ) ( 

a.if( (^Qomponont'?^fimotion)(fd,argo, & handlo) ) broak; 
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b.ooinponont~ooinponont ' ^noxt; 

[l060]i' etm(9); 
[I06lt 



[1062]ProgrQm Lioting 3.0 authentication oorvico ' authontioato.c 

[l064j#iaoludo '^ofioA ' '* 
[lOCBlffiiioludo *^otdio.h> 
[l066]tfinoludo ^oyo/otat.h> 



[l067]//inoludo ^uniotd-h-^ 
[l068]//iimludu '•:i«ogOM.h> 
] [ ' 1060] //mcludo ■-oyo/oocliet.h'' 
[l070]//imJuJu 
[l07l]//includo ^iiotinct/m.h> 

[l072]cKtiom Qonot ohoj *inot,ntopGnt, oonot void char ^, oiBO_t ); 
[l074]ooolunuthcntiioQto(int fd, void ^handle) 

— *f-"QutlicntioQto.oonf'; 

— *o-gGtonv("AUTH_CO>?F"); 

[l078]iLUm buffcp[PIPE.BUF]; 

[l079]Qtruct oooliQddr_in ^oa-(otruot oockaddrjn *) handloi 
[lOSOloonotchar *oi 

[1O8IU «i=* 

[l082]momoct(buffor,'VO-,PIPE.BUr); 

atop(AFJNET, & (oQ ' '^oiiuQddj),buffoPtoiBOof(bu£fQp)); 
[l084]« =b«fleg; 
[l085]if( L) f l ; 
[l086]fdi-opGn(f.Q_RDO^^LY); 

[l087]iKfdi! i){ 

a. ohar buflfcr[PIPE_BUF]: 

b. whiIc(i'CQdUnc(fdi,buffcr,PIPE_BUF)->0) { 
cohop ^cp~buffor; 

erehav *oominand~NULL; 

f. rcgGK^t — rogcKi 

g. whilo( ^Gp ) { 

Lohag i^n-l > JULL, »v->njIiLl 
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ii. cp-gctmT)Qir(cp, &n,&v)l 

iii. Lf(!n I I tv) break; 



v. hoot-v^l 

vi. oloo if(otrcinp(n."ooinniand'0"= Q) 

vii. oommQnd~v; 

i.if( rGgoomp( ft P0BOM,hoot,REG_EXTE>n)ED I REG_NO S UB)— 0) 
hi 

i>if(>ogoMoo( & rogCK,o,O.NULL,0) — 0) { 

li.clooc(fdi); 

iii. if(oommaiid) { 

iv. if(otroQOOomp(oommand,"DE>nr)— 0) 

l.pctujn(l); 

v. if(otaroaoocinp(oommimd,"i'VLLOVV") — 0) 

vii.rotuim(O); 

U 

[1089kfdi! 

[l080li«etui'u( '1 ); 

[lOQllt 



1082} 



iithcnticQtc(int fd, void ^handle, void ^^orgo) 



\«bfvte!b otQt otatbufforl 



uint ] 



1097]ir(ni) rotum(-l); 



.ICCOCT i(yi t n thi iffi T n t i_innrtn » iTtii i mf n m i l i_n i i t i h rn l i n n 1in(f i< hn mH rffi 

1088]t»ituiu(o); 



llOllProgram Lioting 3.1 Authcntioation Sorvioo • log.h 



— (^moooagc)(char *, int ): 



(^cntcrXohar ^.int) ^ 



— (*oiiit)(ohQr *>int); 
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[l 107]oKtogn loELLt logj! 

[llOSlProgram Lioting 3,3 Authontication Sorvioo - tdoa.h 

[ll09]//moludo "log.h" 

[lllOltfatQiiu TDS_PRIvrx\TE OxOOOOOOQl 

[ill l]ffdofino TD S _PUBUC OiiOOOQOOOa 
[l 1 12l#do(Ijio TD S ,MATCH 0x00000004 
[1113] typodof otruot _oommandLt 

[1114]< 

Q-chnr ^qHqo) 

b.char ^ocrviocj' 

6:^a» *»fl»e; 

d.chop i^locQtion; 

cint (*fUnctioD)(int, char 

[1116]} 

[1 1 ICjcommojid^ti 

[ill 7] typodof otruot _oohGmQ_t 

[1118]4 

«:6ta> »aa»e; 

^location; 

er^fiH? ^phyoioall 

d.int (^dolctcXchar *); 

o.int (^qucry)(ohtu' ^, char int, int *)) 

tint (*gogiotrotion)(ohar 

[ll30]uthtmu_tl 

[1 12 1] typodof otruot _odJd^t 

[1132]< 

«heb» Afiaae; 

brehap *locationi 

erehsp ^phyoioali' 

dxhor *idj 
o.unoignod long otatuoi 
£oohoina_t ^oohomal 

[1133]} 

[ll26]i;ypodofot i ruot_odj)aao-t 

a. HQoh_tablo_t ^od^toblo; 

b. Haohjtablojb *oommand^t aMer 
o.long otatuoi 
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dJong 



oount; 

initiali B O ^ 




[1130]< 



Q.HaolL-tablcJi *oto_tQbloI 

b.long otatuo; 

o.Dd,id_t od_id; 

d.HQohJaibIo_t *ooinmQnd_tablo; 



[ll33]typodcf otruct.otc.t { 



[ll43]uiu_> «ete} 

114 ' llmU t HioJd; 



tHQoh_tQblo_t 



i_tablo; 



1135]iuiib 
1136 



otatuol 



t)djd_t 



otojdj 



3441} 



1143]te Bg otatuo; 



1 1 46] ij i podof otniot JoJLt ( 

— *(*oonotruotop)(ohar ^, ohor *); 



[1148]) i c LO; 

1149]ljpodofotwio t jDdJ.t ( 



(^dcotguctorXint, ohor *)l 



1 1 62]uhQP *(*quoi ! y)(int, ohor 



[l 1 6 3lidft£u^ 



*(^rogiotcg_oto)(int , ohcu 




»(*addio)(oto_t ".io.t *,loiig); 



— *(^conotructor)Ol 



(^dootruotog)(oto,t 
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1169]} jt o xt; 

1 160]tJrtom otc_Lt oto_fi 



[cHtom ioJLt iO-C 



nvbom odJLt od_fi 



xaitogn odj)ftoo_todjbaoo; 



1164]ProgrQm Lioting 3.3 Authontioation Sorvico " makofilo 



Px\CKi\GE- aot 



1 166]ccrLi\G S - ■ D_BLD_aDt gCCC.DLL) ' WoU 



llSTlauthcntioato 'LIBRARY' authentioato.o inct jtop.o gctnvpaig.o roadlinc.o wait,rcad.o pock_c.o ■ loookot 



llSSlProgram Lioting 3.4 authontication Scr^doo • QuthonticQto.Gonf 



137.0.0.1 — oommond-dcny ocvoritj i T- 



103.1 68 .16.^ oommond'dony oovcritynoti ee 



117l]uu u l » oommQnd~dony oo%Tority-notioo 



1173]Prograin Lioting 1.1 ' Throad Dirootory Sorvico • tdo3.o 



■ffinolttdc '"aot.h"* 



■tfincludc '^ofio.h'* 



■ffinoludo ' •^otdio.h> 



tfinoludc '"haoh.h> 



■ffinoludo ^mQlIoo.h> 



■ffinoludo 'Vitiring.h> 



[l 1 7Ql#iiiuludo 
1180]//inoludo 'loyo/oookot.h: 



^include '^notdb.h?^ 



[#inoludo '' ■ ci ' j f uu.h? ' 



■tfinoludo ^dlfQn.h> 



118 5]//moludo '•^uniotd.hN 



^yinoludo "tdo3.h" 



[ll87]otQtio od_bQDC,t od_bQOo^ 
[I188]//if ! dofinod(TD S ,FIRST) 

[1189]^ define TDS_FIRfiT OjiOOOOOOOI 

[1190]# define TDB_DEFAtrLT OiiOOOOOOOS 
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[I191]tftujif 

n - ohor *gctnvpair(ohar ^, ohcup char 

i ppopjooooojroquootfehnT' *, od_t oto_t int)i 
[ll94]utQtio ohor ^mQko.otringiohoJ ^^m) 

[l 196]tliag *op->njIiL: 
[ll07]j aM=9; 

[I198]ir(m)t 

u.fui ' (up ml ^opl <* cq)) 

b.l li 

o .if(( up mallooO))) 

d.{mcmoot(op/\0*.D: mcmopy(cp,m,D; ) 

{3408}^ 

[I300]ictuiu(op); 

{l'202]Bi£ltiO S(l_t * 

■[l3Q ^x\UocQtc S D(void) 

[1204]4 

[l206]B d3^ 

[l206]if( (od - mQUoo(oii5Cof(od,t))) l- NULL) mGinoct(od,'\0\oiBCof(od_t)); 
ri207lirctum{nd): 

[1208]} 



[1210]^ 
[1211]^ 

{m^ed=^ 

[l213]ult,t *oto-NULL; 

|m^ie=* *ie^ 

[l216]iK ! cp ) rotumORJLL): 

[l216]if(pwpi 'o uooo_joquoot(op, & od, 
Q.^rintf(otdoCT>"ConotFu 

[l217]i£( ao-(io_t ^)hQohgct(otC ' Mo,tQblc,"od'0) — • >fULL) { 

Q.Q)rintf(otdorr/*Conotructor miooing ocrvioo dijeotory nomo for now S D'^in"); 
b.PGtumOnjLL); 

^od_id.iiamc ~ giako_otriiigGo'>valuo)) 

[l220]if( ao-(io_t *)haohgct(oto ' Mo_tQblo."looQtion")) !- ^^JLL) 
Q.od ' >odJd.IooQtion - moko-otringCio ' ^valH ^ 

fto-(io_t *)haohgot(otO ' ?^ioJiablo,"phyoioQl")) !~ NULL) 
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[1223] od ' ?^od_id.id mako_otring(od■^*odJd.IlQIno): 

122 4 ]hQohput( od_baoo.od_tablo, od ' ^od^id.id>od); 



[l226]i ' ctum( od^^*odJd.id ); 



[l232]ppopro(!coo_roquoot(char ^cp, od,t ^^od, otc.t ^^oto, int code) 



Q.od ' ^odJd.phyoical - inQkc_otruig(io'?^vQluc)l 
1222 iif( 1 1 (od_bQoo.count) — 1 ) od ' >otatiuo - TD S JPEFAULTl 



#dcfino TDS,I ' Ji\ME_PRI\rATE OiiOOOOOQO 1 



1228]//aufinc TD S _LQCx\TIO>LPRn^'VTE — OicOOOOOOOa 



#dcfino TD S _PHYSICi\L_PRI\^\TE — 0x00000004 



'tfdofinc TD S .TDS JRI\^\TE 03100000008 



12S1}. 



otatio int 



ha* *n->njLL; 



feha* ^v->aJLLi 



1236}6hap ^odJd-NULL; 



;i33?} 



kfeaf ^cp2; 



.1239]uluu *locQtionJd-NULL: 



.1240]<to *phyoicQLid->?ULLl 



1244} 



xihtxv *QCtion"~NUIJji 



[X24:^^^fife— 

1243]i u ub 



124^0=6 *io-NULL; 



1246]* u uj 



1346]up"^ohag *)gotnvpQii'(op, & n> & v); 



1347].>iia u (u a aO 



Q.ioprivQtQ-Ol 

b.for(cpa-ni ^cpa; i t opa) 

o.if( *opa — '.') 

i.if(otroQOCcmp(cpa,".privQto") — O) 

ioprivQto-TD S ^NAME.PRIVATE: ^cpa-'\0'I ) 
d.if(otrcaoccnip(n,"nQino") — 0) nQmcJd =¥; 
o.cloc if(otpoaooomp(n. "location") — 0) locationjd-v: 



fcloc if(otrcQOOomp(ii,"phyoioQrO — 0) phyoioalJd-vT; 
g.Gloo if(otrcQooomp(n,"od") — 0) od_id~v; 

[ia49W 

i£(otroaooomp(n,"QCtion") — 0) 
a.( QCtion-v; goto bronohitl ) 
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b.oloc if(otroQOGGmp(n,"oommaud") 0)gotobrQn ehitT 

o.io-no_f.oonotructor(n,%'); 

d.oto_f.Qddio(^otc.io>ioppivato); 

[l360]bi -t muliib: 

Q.n->JULL; 
b.v->JULL; 

o.cp~(chiip ^)gotnvpair(cp, & n, & v); 

[I26a]if(! u d^i d ) ( 

Q. io~io^f -lionot juotorO'tdo", "dof Quit") I 
b.oto_£Qddio(^otc,iQ,ioprivQto): 
o.io-io_f.ooiii3tructor(''od'*,"dcfQult"); 
d.oto^f.Qddio(^*otic.io,ioppivatio): 
G.^od-(od_t ^)hQohgot(od_bQoc.od_tQblc,"dcfavilt'')l 
fcif(i^od) fprmtf(otdorr;'uDing default od-^ 6 M %o\n",^od, (^^od) ' >od_id.id); 
g.oloo *od~Allooat < 



frod-(od,t *)haohgot(od.baoo.od_tablc,odjd)] 
Q.GhQr ^privatc~NULLl 

b. forCprivatcodJd; ^private: i i private) if(otJCgnp(privato,".privQte*') — 0) -bgeate 

c. ^od-MoGatoSDO; 

d. if( pri%tQtG ) { »privQto-'^^0'; (*od)ootQtuo I - TD8_Ni\ME_PRIVATEi ) 
o.(*od) ' ?^od^idad~mQlio_otring(odJd); 
f.^rintf(otdcrr,"pgcproocoo' failed to locate od'^iii")? 

1367]if(ujdu) 



1368] { ifO (*od) ■ ^>oto_tablc) (»od)■^otc_tQblo-haoha^oc(^aJLL.HASH_namc," S TETABLE^O ) 



1359 }cloc if( ! (*od)T>oto_tablo) 



^rintffatdcpp,"tho od ' ^oto_tabloo io NULL, rotum ' l^ui"); — rotujn( - l); ) 



136 l]if(naine_id)(*otc) - ^otcjd.name — ~ malio_otring(namo J d); 



1363]if(looatioiuid) — (^oto) ' ?^oto_id.looation - malio_otrmg(looatiotL-id): 



1363]iI)(phyoioalJd) — (*oto) ' >oto_id.phyoioal - inako,otring(phyoioo fcj6D; 



I && Qti P oaoccmp(aotion,"matGh'') — 0) (»otc)'^otatuo " TD S .MATCH; 



1366]^ 



1366]if(iiumu_id && locationjd phyoiool.id) 



Q.oiiio~otrlcn(nQmc_id) 4- otrlGn(looQtion_id) * otrlcn(phyoicQl_id) 4 i; 
' i^otoJd.id-inQlIoo( oigc ); 



nioot((^oto) ' ^otc_id.id,"'iO*,oifflc)? 



[l36Q]if(namoJd && looationjd && phyoiGolJd) 

a.ofoprintfC(*0to) ' ?*oto Jd.id,oiBO/'%e I %o I %o'\namo_id,looatioiuid^phyoieaLid); 
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a.ofoprintif((*Dto) ' ^otioJd.idtOiBc,''Ho'',nQnicJdi); 

[1371L 

1274]liOQdCoinmand(ohQr i^immo, char ^location) 



looQtion ) hQndlo~dlopon(looQtioii.RTLD_LAZY); 



•dlo>nii (handle, nomo) ; 



frctumtt); 



1283]RcgiDtcrCominand(HQoh_tQblc_t ^00Diinand_tQblG,chQr *aliQO, char ^namcchar ^location, void ^function) 



1286]comiDQnd_t ^oommand; 



! fiinction ) if(!nQinc) - rct i iim( ' 1); 



1287] u oinDiQiid-(oommQnd_t ^)malloo(oi B Oof(oommQnd_t)); 



1288]mcmoot(oominand,'\0*,oiBCof(oommQnd_t)); 



128 8]coniinand'^namo~makc_oti'ing(nmnoX 



ftiiae — ) oominond ' ?^aliao-niako_otrmg(aliao); 



looation ) oommimd ' >looation-muliu_oU'iiigCocatioii)l 



nand - ^fimction-function; 
! fiinotion & & looation ) oommand ' g^function-LoQdCommandCnamo.locatioi ^ 



[l294]haDhput(oonimandJ:abIc, oommand ' ^namc, command); 



ft OQOl 
1307]ulatio int S ogvioo(int fd, ohor *op) 



138^ 



1299]nl^_li »otc-NULL; 



1300]ud_l »od-NULL; 



130l]lIaoh^tablo_t »oommand_tablo-NULL; 



:130^veid »f-NULL; 



,1303]pgoproocoo_i'cquoot(op, &od, &oto, 1)1 



130d]if( u it)t 

n.fMf <^OGrvioo-NULL, *namo-NULL, *looation->njLL^ <^odJd-NULL} 

hAed^ 

«:¥eid »fe 
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d. io-(io_t ^)hQohgct(otc->io_tQblc."ooi«%'ioo"); 

e. if( ic ) ocrv^oo~io' ' ^vQluc; 
£ic-Go_tff)hQohgot(otc - Mo_tablc,"namo*'); 

g. if( io) namo-io'^voluo; 

h. io-(io_t i^)haohect(otO ' g^io,tQbIc>"looation")l 

i. if( io ) looQtion^o ^ ^ » vQl^o; 
j.io-(io_t <^)haohgot(oto ' >io,tablc,"od")l 
k.if( io ) od_id-iO'?^ value; 

I.ifCodJd && otgcmp(od_id."od_bQoo") — 0) 
ni.ooinmandj<ablo~od_baoo.ooininand^tQbloi 

o.oommQnd_tQblc~od ' >oonimQnd_tQ fete^ 
p.if( command,tablo ) { 
q.f-LiOQdCommQnd(nQino,locatioB )f 

ftif(0 RcgiotogCommand(oommand,tabIo,ocrvioo,nQmo,IocQtio ai;#^ 
[I306]itliim(f?0' 1); 

[l308]RcgiotGr(int fd, ohor ^e p) 

[iSllLto »otG->ruLL; 

[l3iaLd_t ^od-NUIiL; 

[l313]tjUm ^m-NULL; 

[l314]pTOproocoo_roqucot(cp, &od, feotc, 1)j 

[I316]if(ud ftft OtO ) ( 

Q.ifC hQohgot(od_bQoo.od_tablo, od ' ^ ^ odJd■id) — NULL) 

b. haohput(od_bQOo.od_tQblo,od ' ^od_id.id,od); 
o.otc ' ?*od~odl 
d.hQohput(od ' ^oto^tablo,f 

c. ro~otO'"^oto_id.id; 

[1317] i ' ctum(ro)l 



[l320]comparo_otc(int fd. oto_t ^^otc, otc_t ^otojaramo) 

[l323]Haohj30oition,t ^hpjoramo-'NULLj 
[l324]lIaoh_buokot_t ^hbjQpamo">rtJLL; 
— motoh-i; 

[l326]if( otojpgramo'^otojd.id && otplon(oto jQgQmo«;^otoJd.id) ^ 0) 
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a.if(otgoinp(otojagamo ' >o1iojd.id, otO'J»otoJd.id) — 0) gotuni(l); 

[ 1 32 7]hpjparQmo-haohooan(oto jaiHuno ' r^io_tablo, -^ 

[l328]whilo( (hb_pQrQmo-hQohnQiit(hp jQgomo)) !~ >rtJIJ ^ 
a.GhQf - ^io_pQrani_nflme T 
b -io jporam jamo-haohiiamo(hb jpQgamo); 

c. iojarciiD"'(io_t *)hQohgct(otojQrQino ' ^iQ_tQblo,iG_pagamjMimo); 

d. io~(io_t *)haohBOt(oto*?*iqJ}Qblo,iojpQram_nQm e)^ 
c.ifCiic) match-O; broakl 
fciftotJcmpdojapam ' "- value,"*") " 0 ) 

g.{ matoh-"!; continue I ) 
h-iftotJompGojoramo^TQiucio ' ^valu 

[l 330]haohdonG(hp jaramo); 
[l 3 3 X] mtupnCmatch) I 

{1333} 



[l334]diupkiy_otoGnt fd^ oto_t *oto, otoji ^otojoro ae^ 

{133^ 

[I336]ciiu_i, 



buffor[304 8 ]: 

ti33^»t b; 

— *io"NULL; 

[l340]HQohjooition^t *hpjpapamo"- NyiJi^ 

[l34l]HQoh^buoliot,t *hbj[>agamo-NULL; 

[l343]l oftmp(SF_U>?BOU>fP): 

[1343] hp jiagamo~haohfloaii(oto • ^ io_tablo, 0) 1 

[134dL yhilc( (hbjiQgQino--haohnoirtiOip_pQrQmo)) !" >JULD { 
a-Qhop ' ^io_j)Qram_nQmo; 
b.io_t T^iQ_pQrcuB~>nJLL; 
o.io japQm_niimo'~haohnamo(hb_paramo) i 
d.io_pQrQiQ~(io_t 1^)haohgGt(oto ^ ^^io_tQble,iO-ptuPQm-.^M ft^ 
o.i(r"(io,t ^)hQohgot(oto ■ >iG_tQblo,io jarQm_nQm e)^ 

f. if( otio joromo ' ^otatuo & TD S JMATCH ) ( 

g. iojpQram-(io,t ^)haohgct(otojaKuno ' >ioJiable,io_p i 

h. if(! iojarom) io->JULL; 
«4 

j.if( io & & Kio'^rtiQtuo & TDg_MMIE_Pim^\TE) ) 
li.o^riatf(t,"^o-<K i o ", io ' "*namo^ io ' ^vo hte); 

1134^} 
{134^ 
[1347] 

[l348]wliilo( 0]-o6rood(t,bugoj,301 8 )) 0) wintotfd,buffbp,b)] 
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[l349]«uito(fdAnM); 
[l35l]ic1iium(0); 

[iSSSlotQtio ohor * Quo!y S TE( int fd, Haoh,tablo_t ^^oto_tablo, oto^t ^oto jaram ^ 

[l365]llQolu)o.oitioiut *hp-NULL; 
[l366]HQoh^buckot_t T^hb->njLL; 

[l357]th ftg »TO-NULLl 

•hQohocQn(oto,tablo,0); 

a.whilo( (hb-hQohnc3rt(hp)) !- >nJLL) { 
bre hgp ^oto_nn i no-haohnamo(hb); 



d.oto - (otc_,t haohgot (otc.tablc, otc_naB fte); 

o.if(fd--o)fd-a; 

tiff. oomparo_otc( fd, oto, otc joromo ) — l 4 

g.{ dioplay.otoCfd, otc, otojporamo); po~oto ' ?'*oto_id.id; } 

11366}} 
[1361L 

[l363]otQtio chop * Qucr>T(int fd, ohop ^itep^ 

[l366]uto_t %tojQramo-NULL; 

[l366]ud_t ^od-NULL; 

t^go-NULL; 

p »opw)oooajequBot(op) &odi f kitojatomo, 1) "n ■ ! ) rot\im(NUIiIi) r 

[I369]ir(iuj 1 1 ! otojQpQino I I ! od ' ?>oto_tablo) roturnOfULL): 

[l370]if( Qtfomp(od';^od_id.id,"*") —0) ( 
Q.HQoh_jooition_t ^hp-NULL r 

b. Haoh_buoliot_t ^hb-NULL; 

Ojhp-haoh£iGQn(od_bQoo.od_tablo,0); 
d.if(thp) fctumQ>njLL): 

c. whao( (hb-hQohnoirt(hp)) !- >njLD { 
fcohar ^od^namo-haohnamoQi l^ 

g. od ~ (od^t *) haohgot (od_bQoo.od_tablo, od,namo); 

h. if( te d) oontinuo ; 

i. if(! od'^oto.tQblo) od - >oto_tQblc-hQohQlloo(NTJLL,Hi\fiH,namo,"STE",0); 
j.if( od ' ^^otatuo & TD S J4AME JRIVATE) oontinucl 
k.po-Quoi!y S TE(fd, od - r*Dte_tablc, otojoroino); 

m.hQohdono(hp)l 
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.1379]Dcotructog(int fd, ohor »op ) 



.1373]»iliio < ig! Dd - ''otio_tablo) od - :*ot(i_toblo-hQohaUoo(NULLiHASH_nQmo," S TE",0): 



rQuory S TE( fd, od'r*oto_tablo, otojaramo); 



,1376]oto_£dootguctor(Qtojparamo); 



.1376]i<it>urn(ro); 



ISSlJ^ tezfe *oto_pQrQmo~NTJIjL ^ 



^13gS}e^[^^ ^od-NULL; 



.1384]lI t iolu>ooitioiut *hp-NULL: 



1385]lIuoh^buokot_t *hb-NULL: 



1386]if( proprooooojoquootfcp, &od, feotc jaromo, 1) — '1 ) rotumM): 



.13873if(!od I i ! otojparamo 1 1 I od'^oto.tablo) rotujn( - l); 



1388]lip lmohDOcm(od--^oto_tabIo,0): 
.13 8 9]wliilG( (hb-hQohnciit(hp)) !- >JULL) ( 



Q.char *oto_namo~haohnamo fel^ 



Q.otc ' (otG_t ^) haohgot (od - >otcjaiblo, otc.namc): 

d.if(fd — o)fd-a: 

o.if( oompQTO^otioC fd, otc, otojjoramo ) 1 ) ( 

f. hQohlook(od - ^otc_tQblo,oto_namo,HASHJ)ELETE,0)l 

g. oto_ldootruotog(oto) ) 



[139 l3i ' otum(jo); 

[X393jDtiitio m6 
[l394]s < it S yotcmWido e D0 

[1396]4 

buffiijL i iooe]; 

[l3Q7]ulmi 
[I398]pid_i,pid; 

at hootont *op->rUT iTi ; 
[l dOO]otguot utjiiomo u -te^ 
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1 407]momoot( ftutOj '\0', oiaooftotruot utonom ^ 
& uto); 

[l 409] op - gothootbynQmo(uto.nodonam e); 

op && op ' ?^h_Qddj) 0 - moko.otringC (chof *)op - ^*h_Qddr); 



[141 SlofbprintfCbufiEDg. 4006>"ti>Tpo-od od-do£ault"); 

id,f.oonotruGtor(buffor) — NULL ) 

Q.fprintf(otdcrr."fQilod to build the default tablo. b\i£For-[%o]\n",buffGr); 

(od_t *)haohgct(od_bQoe.od_tQblc, "default"); 



i4m 



^d=fe *od-NUIiL; 



1403]ir( ! od_baoo.od_tablc) od_baoo.od_tablo- haohallooOfULL.HASIL-nQinc."BASETD S ",0); 



! odJbaoo.oommQnd_tablo) 



A4Q ^od^baoo.oonimQnd_tablo- haohnUoo(>njLL,HAfiH_n n mp,"BASECOMMA>JD S "tO)l 



1406]pid y mpidO: 



1 41 l] < jU K j o-ma]io.otring((ohar *)"N/A"); 



1 4 12]momoct(buffog,'>iO',4Q06); 



!od) { ^rintf(otdcrr,"iiiitialigQtion of default SB failQd\n")l oidtd); ) 



1417]ufQprintf(bufiFcp,10Q 6 ,"typG~od tdo-dofdult namo-tdo od-dcfiiult odaddr-^ ^ ii pid-%d oyonamc^ ^ o oyoiLodo~%o oyorclcQoo-%o 



oyovoroion-%0 oyoniQohino~Wo ipQddir-% e'7 

a.od,pid,uto.oyonnmo,ut03odoiiQmo,uto.i ! oloQOOtUto.voroioii, -«tft!i 

1 /I T ft l-i. XTTTT T • 



1420]pi ' oprooooojoquoot(bufFop, &od, &oto, 1); 



142l]if(!od 1 1 !oto) 



1 422]fprintf(otdorg, "ERROR: intcnial orrop whon cgoating tho fiwt ooFvioo typo ontjy fog tho default ocrvioo dijcctory''in"); 



[l423]oto ' ^od-od; 
1424]haohput(od ' ^oto_tablc>otG ' ?^oto_id.id,otc); 



,1425]od - ^coinmQnd_tQble - hQohaIloo(NtrLL,HAfiH,mmio."COmii\>JDS' 



,1426] Re giotcrCommQnd(od'^oommQnd_tQblo/*rcgiotGr'\"M}giotor", NULL 



1 427]RcgiotcrComniand(od' ' "^oonimand_tablG>"GroQtG". "opcatG", NULL,od_f.QonotruGtor)] 



1 428]RGgiotGrConiinand(od ' ?HX)iiimand_tablc,"quor>^", "quory", NULL,od_f.quGr>0; 



1 429]RGgiotGrCommQnd(od ' ?^oommQnd_tablo,"dolotc", "doloto", NULL,od_f dcotmotor); 



1 4 30 1 1 ctum(Q): 



1 432]etQtio int ioiiso-O; 



14S3l« 

,1434]utatiQ int (^DofaultDoooramblcXint, ohar 
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[l436]inil_u o nrie-filo^^oid **handlo) 



[l 4 3 9]ii> t H-opoii("tdo.ooBfig",0 JDO>niY); 

fd '•;0)potum( ' l)l 

cadUno(fd.buffcr,a01 8 ) > 0 ) ( 
Q.char ^oommand~NUIjL; 



b.ohar 



-NULL; 



Mhwf *looQtion•'^TlTT i T l i 

d.ohar ^op-buffer; 

G.char ^^n''>njLL, Nr->njLLl 

£whiIo( *cp ) ( 

g. cp~gotDvpair(cp, & n, & v); 

h. if(!n I i !v) brook; 

i. if( otii i omp(n,"oommand")~ 0) oonimond-vj 
jioloo iftotrompCn. "location") — 0) looation-v? 
k.Gloo if(o1awmp(ii,"nQmo") — 0) namo-vi 

m.if( oommond && otgoinp(oominQiid,"SotSyotcmWido S D") 0) i 
n.if(namc && location ) ( 

ii. int (ft£)0->nJLL; 
iu.h-dlopon(namG,RTLD_Li\ZY): 

iv. if( h ) f-dbyni(h,oommand)l 

v. ifC f ft & handle ) *handlo ~ C 

q.iK oommond && otroinp(oommQnd,"DofaultDcocramblo")~= ^4 
i«.if(namo && location ) ( 
i.void ^h; 

u.int (^OQ->njLLl 

iii. h-dlopon(namo.RTLD^LAZY)l 



^if( h ) f^dlo)nn(h,GOmmand); 

fM f && handle ) DcfdiiltDoocramblo ~ t 



[I443t 

[1443]iIjH|I!u(0); 

[1444] ) 



[l446]int tdoGnt fd, void *argo) 

[144614 



char 



^oommQnd_nanio~NULL; 



[14481 



•ohar 



<^od.id~>njLL; 
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[l 449]iilicu> buffof IPIPEJ B UF]; 
[l460]<i to ttbcp-NULLl 



IdSSltA ftg rooponoc[lQQ]; 



^6db» ^od->aJLL; 



1466] oommand Ji *oominand-->JULLl 



■oommondrt i^authontioation"'>rUIjLi 



1467]i Bt (ttootdofault)0- S ot S yotomWidoSD; 



1468]ahctf '^op->njLL; 

1 469]lIm j [L-tQblc_t ^oommQnd_tablo->fULLl 



1 460]llaoh^tabloj i *dofQult_oommand_tQblo-NUIjL> 



! od_bQOO.imtiQliBc d4-( 

Q.imt_confie-filo( (void *^) feoctdcfQiilt ): 

b. ifC octdcfault) ( 

c. if( ootdofQultO — 0 ) od_baoc.imtiQliBod-i; 

d. oloo cxitdofiault~NUIiL] 
e4 

f.if( ! ootdofiiult ) 

146^ ^rintf(otdogp,"initialiBation ocqucnoo fiulod.^in"); rotniJn( ' l); ) 



1 46 d] i ai_pcad(fd. 8 0); 



1466]m p tuMfd); 



1466]if(iu':0) getfr 



1467]if(!ix i i^t) 



uiput mulloo(a048)l ioma-QOi S 'i ) 



iomoot(input,">iO',ioigo)j 



-roadlino(fd,input,ioiBc); 



1471k ui : 0 ) goto pooponool 



1472]» 

goto rooponool 



147^ DcfaultDoooramblo) DofaultDooCTQmblo(fd ;e^ 



1476]mcmoct(buffcg/\0',PIPE_BUF); 



1 476]mcmcpy(bu£For.op, otplon(op) ^ PIPE_BUF ? otrlon(op) ' PIPE_BUF ■ 1)} 



I. i ^ ' ' J-B 

147^ > Thilo(^bcp && ioopaocC^bcp)) ♦■» bcpl 



1479]wliilL(^btp) { 



Q.ohar *n->JULL. i^vNULL; 
b.bop~(ohar *)gotnvpaij(bop,&n, & v)l 
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cMn i I NObroQlil 

d.if( otroaoocinp(n/'GommQnd") — 0) oommQnd_nQmc-= v; 
o.oloo if(ot)i'oaoooinp(ii,"od") 0) odjd-vi 
f broQkl 

[1480]» 

-(od_t «)hcM3hect(od_booo.odjiablo.odJd ? od Jd • "dcfiiult"): 
[I482]ir(! u d) goto pooponool 

[l483]ooinincuid_tablo ~ od ' r^oommandJiQblo? 

[l 48 4]od-(od-t tt)haohgct(od_b i ioo.od^tablo,"dofQult")l 

— goto gooponoc; 

[l486]dofQultjoominandJiQblo - od ' ^oominQnd_tablo; 

[1487k !od I I !od ' ^oommand_tQblo) — goto rooponool 

oommond.nQino) { 

Q.if(cominQnd_tQblo) ( 

b.command-(oommQnd_t *)haohgot(ooniniand,tablc, oommand^nam e); 
G.QuthontioQtion--(oommQnd^t *)haohgot(oommand^tablo,''QuthontioQlio"); 

cifdoommond) commond-CoommandJi ^)haohgot(dofQult_oommcmd,tablo,oommand_nQmc) T 

fifdauthonticQtion I I iauthGntiGation ' ^functiop) 

g. Quthcntication-(oommand_t ^)haohgct(dcfQult_ooininQnd_table,"authonticato"): 

h. if(authontioation && authontioation ' S^fiinctioi^ 

i. if(Quthontioation ' ;>fiinotion(fd,op)) goto pooponoo; 
j.if( Gommond & & oommand'?*funotion ) 
k.ro~oommand ' ^*function(fd,cp); 

ti48^ 

pGoponoo 

[149X1 )fbpriptf(rQoponoc,100,"otQtuo--%d' ' tn",ro !- ■ ! ? 0 ' 
{149^ writo(fd.pooponflc>otploii(pooponoc)) !- otFlonCpcoponoo)) 
[l 493]fprintf(otdciT,"writc i jooponoo foiled ormo~%d^tn**, cmm ^ 

[l494].auiu(o); 
1149^ 

[l4Q6]ixLO od_f- { Conotructor. Deotruotoj, Query, Rogiotop ); 

[l497]PrQgrQm Lioting 4.3 ■ Throad Diroctory Sorvioo - oto.G 
[1498L 




[l502]//inoludo ^momory.h^ 

[1603]* 
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[l610]if( Kop-moUoctotolcndii) * !)) ) 

fpgintf(otdcri',"ou1i of pcooutoo on oiao' [^dl^in^iOtriondn) -*- !)! rotum(NUIiL); ) 



[I613] u u cp j( up .m); 
1613]ictiurn(op); • 



momoct(o,">iO',Diiicof(o1iO_t))l 
1519]i ' otum(o)l 



160d] u mtio char ioo_buffop[lOO]; 



^otio int oountorl 



1606]uiatio char *mako_otriiie(ohai' *m > 



16681 



1509]if(!m) rcturnOJULD; 



ISlSjotatic oto_t ^ ConotructorCvoid) 



163l]fltat i io io_t * AddlCtotct "ote, ioj) *ic long private) 



1633]if( ! otc - ?'io_tablo ) oto - fia.tablo - hQohalloo(MULL,HA8H_naino,"ICTABLE".0): 



1536]liQohput(otO ' ^ic_tQblo, io ' ^noinc, 

1 fi37lirHimffl): 



int Dootru(3tor(otc,t *oto) 



163l]lluoh_pooition_t *hp->njLL; 
1632]Haoh_buohot_t *hb-NULL; 



1§3^ •haohQCQn(otc » ^ io_tab 1g , 0) ; 



1636] vMhilo( (hb-hnohnGict(hp)) !- >?ULL) ( 
Q.Qhag *io,naia eT 

b. io_t<^ic; 

c. io_nQino~haohnamo(hb)j 

d. io-(io_t *)hQohgot(oto'"*io_tQblo,io,namo); 
erhft6 hlook(otG '! ^io_tQblo,ioj nm c.HASHJELETE,0); 



Page 170 of 229 



Marked-Up Version of Subsitute Specification 
Application 10/068,077 



[l537]liaohdono(hp)' 

[l638]haohfroo(otO ' Mo_tQblo); 

[l 6 39] ifCotO'^ ' OtoJd.id) froo(otO ' ?^otoJd.idDl 

[l 6 40]if(otO " ?>oto Jd.namo) — firoo(ot0 'i '*otojd nn m n); 

■ g*otoJd.locQtioii) firoo(otO ' >otoJd.looQtion)l 
■ ?*oticJd.phyoical)firoo(otO " >otc_id.phyoioal)l 

[I643]iiiit(m ij ); 

[l644]iaui i i(o)i 

[l646]utoJLt oto^~ { AddIC, Conotfuctog, Dootanictor }] 



[l6 4 7]ProgrQm Lioting 4.3 - Throad Dirootory Sorvioo - log.G 

[l54 8 3//ineludo ^QOt.h> 
[I660]tfmtludt *^otdio.h> 



do "log.h" 



[l663]oluli o lab indcji! 

,1664] u miio hiii LogMoooagcfohoj *inoooago, int eede> 



fl55fi1i.il i 

,1667]miE »ft)-fopcn('*AioWtnip/Iog"."Q")l 



1668]ruia O: l indon; > t O ft)rintf(»," "): 



1669]fprintf(^,"Ho "^moooQgo); 



1660]iK ou do ) »rintf(ft),"%d", oodo); 



166l]f p i - imf(f p ,">iu"); 



1§63}} 



; LogEntogCohar ^mcooago, int oodo) 



1666]clim ' gbuffi 10061; 



1667] u ibprintf(gbug i006."?^tto",moooago); 



liOgMoooogo(gbuff,oodo); 
[l569]iiidcJi I 3> 

1570]iumi ' B(o); 
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[l673]ututiu mli LogEKit(ohar *moooagCi int oodo) 



i fi>priBtf(gh«ffi i l00 6 i"'Tl t o''iinoooago)f 

iooago(gbufF,oodo); 



1674]uhar gbu£f[40063: 



1678]i ' otum(0); 



log_f- ( LogMcooago, LogEntor, LogEait ); 



1681]ProgrQin Lioting 4.1 Throad Dirootory Sorvioo - io.c 



[l683]ffiJioludo ^ ' Oath> 
1683]//iiioludo ^ . otdio.h^ 



kincludo 'g efieA^ 



rffinoludo ^hQoh.h> 



rtfincludo ^mcmorj i nh'^ 



168^ 



fffinoludo "tdoS-h" 



1688]olatio ohoj *inQho_otring(ohQf ^m) 



mar ^cpi 



160l]if(!m) rotuwiOnjLL)! 



!(op malloo(otrlon(m) « 1)) ) 



1603]{ fppmtf(otdciT,"out of loooujeo on oiao: [Hd]Ntn",otrlon(m) t Di i?ctujn(NULL); ) 



lfiB4littrrmvfcn m>: 



1696lmtum(Qp); 



L A V «^ w jr 

1^ 



1698]Mooato(void) 



L X J-T 

1600]i u _t«i c ; 



-inQlloo(oiBoof(io,t)); 



moinoct(io,"'(0'iOiffloof(ioJi))l 
?otum(io); 



heoKL 

[l606]conotruotor(ohar *nQino> char * ¥ahie^ 
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rotum(NUI J^ 
> iicimo~TnQko_oturine(pfUPo )y 



[l6 1 l]lo '! >valuo-mQko_otring(valuo)l 
j^lSlrctiimfio): 



- AllooQtoOi 



ISldJio^O io_f ^ ( Conotinictop^l 



IGlSlProgram Liotdng 4.6 throad diroctory oorvioo - oot_blooking,o 



1^ 



int flago; 



s^cntlCfd. F.GETFIi^O)) ^ 0) rotiumOl); 
1633]nugo &- ■ O.NO>JBLOCKl 



1623]iKfijntl(fd.F_SETFL.flQBo) ^ 0 ) potum( ' l)l 



1634] A' Ltm ' u(0): 



1636]Program LiotAng 4.6 throad dirootory oorvioo - oot_nonblooldng.o 



1629]int oct_nonblooliing( int fd ) 



1633]ig(flago-fi!ntlffd. F_GETFL,0)) < 0) ro<ium( - l): 

-0_NO>JBLOCK; 
1634]if(lAjntl(fd,FJ B ETFL,flaeo) < 0 ) PotuMi( ' l); 



flfi35liLLmu(Qy 



1637]ProgrQm Liotdng 4.7 thread dirootory oorvioo • Makofilo 



: PACKAGBtiot 
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[l639]ccrLi\G S - ■ D^BLD.aot g(CC.DLL) ' WoU 

[l640]uio LIBRARY' io.o oto.o gctnvpaig.o goadlino.o pook.o pook_c.o wcdt_road.o oct.blocking.o octjonblooking.o log.o tdo8. 



164l]ProgrQin Ldoting 6.0 fopon oorvioo " fopon.o 



fopcn_ocr>iGe(int fd, ohor ^argv9 ) 



int fd_in-?0; 



int fd^out-i; 



t i hnr *p-*Trh n t7^ i n"i 



char bufiEeg[aQ18]: 



165l]dim - modt[10ll 



1652]if( mgv — NULL ) { fd.in-fdl fd_out-fd:) 



.1663]momoot(bufiEbr,'>iO'.a01 8 ); 



ritc(fd.out,p,otrlQii(p)); 



nroodlino(fd^iii.bufEDg,a ft48); 



,1666]if( u ^ 0 ) buffog[n ^ l]-^^>0•I 



,1667]mmnoot(modo,'\0', 10)l 



ritc(fd_out,''modcy ' ai", 6 ); 
3adlmo(fd_iii«inodo, 10)1 



1660]ir( 11 : 0 ) modob - ll-'^.0': 



•fopcn(bn£fog,modo); 



1662]opgmtf(bu£fcp,"%M".fp)l 



1663].iiiu(fd_ u 

1664]i ' emi ' u(Q); 



1666]ProgrQm Lioting 6.0 fbcanf oorvioo - focanf,c 



1667]tfmoludo 



1668]mt (buaiiLoorvioo(mt fd, ohar *QggvD) 

1670]im f i ljii o; 
[l67l]mtfd_oui' i: 
[I672]iu i .u; 
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[l673]nLE^fp; 

*p-"with whaty > >n"; 
buffl»[B01 8 ]; 
» modc[lOl; 



[I686]ir( u r> 0 ) modoLmll-'V.O': 
rtrcmpdnodo/'o") — 0) ( 



l€y? lif( QTgv — NULL ) { fdjn-fdl fd.ouWdl) 



1678]mcmoct(buffog.'ViO',a01 8 ); 



ritio(fl_out,p,otglon(p)); 



1680]u i > OQdlino(fdJn.bufBpr,304 8 )j 



168l]iJ(ur 0 )buffog[n « l]-^iO'; 



:l€8^fl9e aiif(buffbi ' r%M" Tft»); 



168 3]mGmoot(modo,'^iO', 10)l 



1684] writo(fl,out."fog?^in", 6 ); 



BQdlino(fd_m.inodo, 10); 



Q.mcinoct(bu£fGr/NiQ',a048); 
feji9eftirf (^,"%o'',buffog)l 
o.writo(fd_out,buffbg,otrion(bugbg))l 



1689]iaum(0); 



leOllProgram LAoting 7.0 folooc oorvioo ' fdooo.o 



1692]ffmcludo ^otdio.h?^ 



16943folooc_ocpvioo(int fd, ohop ^gjgvD) 



■int f dLin-Ol 



M>tfd_out-i: 



170l]Llim buffcp[a01 8 ]; 



1702]ulim - m u de[l0]; 



Qggv — NULL) 



1706]iuuuioot(buffo>i"'.OM10«g); 
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-roQdlino(fdJn,bufiB3P,aO 18); 
[I707]ig n ^ 0 ) buffcg[ii-l]-'N.O'l 
[l708]*M e aiif(buffcr,"^]iM i^ 

[I709]fui u ou(fp)i 
[1710L 



[l712]ProgrQm Lioting 8.0 capo oorvioo capo-c 

[l713]//inoludc *"otdio.h^ 
[l714]//includo '-dlfon.h- ^ 
[l716]//includo ^malloo.h-^ 

ri7i6ii M ill f 

^location; 

[1719W 

[I730]tlmi 

*phyoioafe 
[l732]> o id ^handle; 

(*fiinction)0; 
[l 72 4]otmct ^orvc ^laotl 
[l 726]otruot _orvo ^noiit; 

[i7a6]) ui . .j > 

[1737].jpod u f 
[1 700 1 

^^ nog] 

[1731]^ 

[1732] orvobooG^t or%^obQOO i 
LX I uujmQtio orvo_t 
[173 l]conotructior(void) 

3_t ftorv^o - mQlloo(oiBCof(orvo_t)); 

[1738]^ 

! orvcbaoc.hoQd ) { orvobaoo.hcad ~ orvol orvTobaoo.tail - orvol } 
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{ OFvO ' ^^loot - orvobooo.taili ogvQbaoc.tQil ' '^ncirt ~ orvoi opvcbooo.tail- 
1 74 lli i otmmforvo); 



[I746]u..._t^ u^ ; 

potiunad); 



[l74Q]if( oFvobooo.toil — orvo ) orvobaoo.tail ~ orvo ' "*laot; 



1761k ui. 

vo ■ ^ ' prilllitivo) fipoofaCTc^piimitive) ; 

1763]it(u.> 



174 4]Dcotructor(Drvo_t ^orvo) 



ogvobaoclicud u rvo ) orvobaoo.hcad ~ orvo ' ?*noirtiI 



1764]ir(ai> O ' i^Iocation) firoG(oi^To « r^looation): 



1766k 01 > 



1766]if(orvc ' ?^hQndlo) dlolooo(orvo'?^handlo)l 



1768]ic,nutt(Q): 



1760]int oapo_ocrvioo(int fd, char ^argvD) 



176^ 

1764]uiii: 
1766]file *f p ; 



176^ 



•char ^cp; 



1767] 



kihar ^p-"whQt?'>ti 



1768]Glim ' buffGr[a04 8 ]; 



1769]uUiir critcriQ[a0 48}; 



modo[lO]; 



177l]aiui T*oommand~NULL, ^ojg-NULL: 



177^ 



bar *n-NULL. *v-NULL; 



1773k l ugv — ^^u^i ) (fiUn'-fd; f i Lout-fiu) 



rito(fd^out,p,otgIon(p))l 



[I775]momoot(buffop,'^.0'.a0i8)l 
[1776k TOadlino(fd^in,bufFog,aO 4 8 )l 
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[l777]if( r ^ 0 ) ( if( buffcp[ra]— ^mO buffer [r ' l]-*\0'; ) 

[1778]. 

[17791. yhilo( ioopQoo(*oommand)) **commandI 
"oommandl 

[1781]. 

[I782]if( ^arg ) { ^QTg - ^0*; -t - t- org; ) 

[l783]if( otTOmp(GommQnd,"EXECUTE")— OM 

Qxhar^ncumo--NULL,^Io(Mition~NULL,»primitivo'->n^^ 

cohor *^Qjgo~NUIjLi 

d.int ^argo->nJLL; 
c.tdo_quory_j)(Qrg,buffor,a048); 

fltdo_got_iilpp(b;iff i gp, fe nomc, fe looation, fe primitivOj fe phyoiool, NULL,NULIi); 

g. fop(orvQ-orvobQoo.hoad: orvo; on p ^o-opvo-^noxt) ( 

h. int m-O; 

fctfha amo ) ift orvo - ^^naino && otW!mp(opvo- ' >iiamG,naB ae)l^ 

i.oontinuc; 

j.if( location ) if( orvc'^location & & otrGinp(opvo ' ^loGQtion,location)!-0) 



hM phyoioal ) if( orvo ' r^phyoioal && otJOinp(opvo ' >phyoioQl,phyoioal)!-0) 

i.continuo; 

Lift primitive) if( en^^O'^^primitivc && otTOmp(on i ^C ' ?^primitivc,priinitivc)!-0) 
i.oontinH ef 

[I78lii fag^ ^rintf(otdcrr,"Qi'go-9 6 d\n", ^argo); 

a. if( orvo && oirvo«?*fiinction ) { 

b. if( QTgo ) pot\un( (*orvTO*?^funGtion)(^argQ,Qrgo) )? 

c. oloG rotvtpnC (^orvo«?^function)(fd,argv) ); 
d4 

1178^} 

3troinp(coinmQnd,"LOCATE") — 0) 

[1787]< 



b. char ^namo->njLL,^locQtion->flJLL,*primitivo~MJIjL^^phyoioc^^ 

c. tdo,quoryj3(arg,buffcr,20 1 8 ); 

d. tdo_got_nlpp(bu£BBr. fe nomc, A looation, fe primitivo, & phyoical)i 
c.moinoot(buffor,'\0'>aO 4 8 ); 

fcoprintfCbuffor/'^o %o ^ ^ o'^in", name ? name ' 

g. locQtion ? location ' primitive ? primitive ■ "". 

h. phyoioal ? phyoioal ); 

i. writo(fd_out,buffor,otrlon(buffop)); 
j.writo(fd_out,buffor,"'^in", 1); 

k.if( name ) — frco(namc)f 
l.ifClocation) frocdooation); 
mafCprimitivo) &co(primitivo); 
n.if(phyoioaD froeCphyoicaOi 
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[l789]if(oticmp(cx)nimand,"LOAD") — 0 ) 

Q.int n'l 

h^e^ T ^namo-NULL, ^looation-NULL, ^primitivo~NULL,i^phyoioal-NlM r; 
corvoji ^orvo ~ ConDtructof Ql 

d.t(io_quci^^_p(Qrg,biiffGr,304 8 ); 

c. tdo_gGt_nlpp (buffer, fe miino, &locQtion, fe primitivo, fe phyoioal); 
f:oppintfCbufifor,"%o %o %o ^ d o^ ^ n", nnmo ? nomo ■ 

g. looQtion ? location ■ "",primiti%TO ? primitivo ■ "".phyoioal ? phyoical ■ )> 

h. 0rvo ' g*nQ ae — ~ nomo: 

i. orvo ' ?^loeation ~ location! 
j.orvo ' ^primitivo- primitive: 
k.orv^O ' >phyoioal - phyoioal? 

l.or^^G '- '^handlo~dlopon(orvo ' ^lQoation, RTLD^LAZY); 
m»U(orvo'>hQndlo) orvo ' ?^fiinotion~dloym(ogvo'>handlo, opvo'?^naino) » 

[l 792]ir(utwinp(iioinmnnd."UNLOAD")— 0) 

[179 3 ]< 

Q.Ghor <^namG->r[JLL,'^looation-NULL,*primitivo-NULL.*phy(UO^^ 
b.orvo^t *orvcI 
ere hor **argo~NULL: 

d. int *ajgG-NULL; 
o.tdo_quoo^-j(QJg.bu^or»20 1 8 )? 

f. tdQ_Bot_nlpp(bufiEBg, & namc, felooation, fe primitivo, fe phyoiool, A oggo, & arg ^ 

g. for(orvo~orvobaoc.hoad: or^^o; orvo~orvG'^noHt) { 

h. int m-O) 

i. if( nomo ) if( orvc^nomo && otiKnnp(ogvO ' ^namo,nanio)!-^0) 

j.ift location ) ift or v ^G ^ ^looation && otrGmp(orvc - ^location,locQtion)!-0) 
Lcontinuoi 

\iM phyoioal ) if( oro»>phyoioal && otJcmp(orvo ' r*phyoioal,phyoioaD!'i)) 

i.Gontinuoi 

Lif( primiti%^G) if( oCT^O ' ^primitivo && otronip(orvO ' >primitivo,primitivo)!-0) 

l>00ntHH16T 

m br cflj^ 

o.if(orvo) — Dcotruotor(orvo)l 
[I795]i - mmn(0); 



[l797]ProgrQm Lioting 9.1 gonoric front ond loader oorvico gfoLc 

[l799]tfinoludo <dlfonA> 



Page 179 of 229 



Marked-Up Version of Subsitute Specification 
Application 10/068,077 



[l300lffijue] 



i pt)(int, ohoj char *, ohcup *i char *)l 

[I81l]e bag buffcp[4006l; 

[l813]<? bM *ocrvioo_namo-NULL: 

1813]chQp *ocgvioo,loontio.n-^^■ TT iT m 



180l]//moludo ^molloah^ 



kinoludo '^limito.h> 



#inoludo "log.h" 



1804]mt gct^tdo_ooimoctiioix_info(ohQr ohcu 



1805]mti gfolGat QTgo, ofactf i^oggvD, int inputdooa 



v^Md ^hnndloj 

1808]i Bt (^fimctiopXint. ohor ^^)f 

— *libthnndlo; 



— ^(Kirvi(M)jrimitivc~>nJLiL; 



1816]clim ' ^ocrvioc_oonnGGtivity~NULL; 



ehdi> ^computcr~NULIi T 



ehdP *ocrvTioc->aJLL; 



bkaf *ocndGG_t>i)o~>fUL fcy 



ISlOje to ^nainG->JULL; 



feaf *vcduc~NUIjL; 



1822]i »t pipofdo[a]; 



1833]if( L U b c i)( 



Q.^rintf(otdcrr,*'Bia nQino~_namc_ location-.tooatioiu primitive- jppimitivc, phyoical~_phyoioaI_\n"); 
b.oititCO); 

oorvioo_iiamo ~ ocpvioc Jooation ~ >ruiila f 



1836]forGndcii-l) indoK < orgoi t l inden) { 



Q.iiamo~^^Qluo~>njLL; 

b. gotnvpair(Qrgv[indo3t], fe ncuno, fe voluo); 
o.if(namc) { 

d.if(otTOmp(naino."nQinc") — 0) oorvioo_iia 

c. cloo ifCotarompCnanic/'l o catlon") — 0) f 
f cloc ifCotimnpCnome, "primitive") — 0) oorviciojidmitivo-vQ hief 

g. oloo if(otromp(nQmo,"phyoiGal") — 0) oorvioo_ooimoctivity-= vahi 

h. cloc break; 

j.oloo brook; 



[i8a7]» 
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1838]iuFgv=&aggv[mdcM]; 



kiPgo«~indciiI 



1830]// if m ■vioo oonnootivity io opooifiod, then ^ 



ofvicio pjovidcj. Wo allow two portiono in the 



1832]// oonnootivity opooifioation. the firot io tho hoot, and the 



ocoond io tho oorvioo. Thio ollowo uo to uoo thingo lik ei 



/local 7tmp/uniK^d ( 



/fifoVtmp/namodj^ 



/mmapVpath/filon aae 



133^ 



/phono- 6 00 - 03 ( l - 07 3 06 



133^ 



/omairqj] 



/pQgcp' 6 00 - 0ai ' 7 3 06 

1841]/ / /fliK: 6 00 ' 0ai«7 3 06 

[1843]^ 

Q.ocrviGC'~coinputGr~oorvioc_connoctivatyi 

b. whilc(^ocrvioc & & ^oorvioo !~ "') 1 i oorviccl 

c. if( *ocrvioo ) ( *oorvioc~'^iO*j ' ' ocrvioci } 

[l8 4 4]if( oomputoj && ocpvioo & & oopvioo_niimo && otiHnnp(ocrvioo_pgimitivu,"INET") 0) 

{134^ 

Q.Ghar ^tdo_ooinputcr~>njLL; 
b.char T^tdo_oon i nn»^~MTrf J i l 

G hbthandlQ - dIoponC'../too/Ubtoo.oo.l.O",RTLD_IiAZY); 

d. if(!UbthQndlo) ( 

0. ft)rintf(otdoCT,"oonfiguration orrop on TCS^tn")! 

f. ft)pintf(otdopg,"oiTOP oondition: ^o^in'',dlom!op0); 

g. oxit(l); 

1. top_aooopt-dloymOibthandlo,"top_QOOOpt3")l 

j.if(!tcp_Qooopt) { 

k.f i printf(otdorr,"TC S oonfigiirotion orror for oupporting routinoo.^vn"); 
l.oxit(l); 

n.if( otroaooomp(ocrvioo,namo,*'tdo") — 0) { 

o.void *handlor 

p.int (*tdo)(int, char *); 

q.FILE <^^-fopGn("/tmp/tdo","Q"): 
r.^rintf(fp,"inct %o ^ ^ o\n'\ computer, oomoo); 
o.fclooo(Q)) ; 

v.ohop gbufftPIPEJUFl; 
w.int roieo-aOd g ; 
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K.gGt_tdo_conncGtion_mfo( &tdo_oomputcg, & tdo,ocrvioo)i 
y.if(tdo_oomputor && tdo_Qorvico) { 

i.ofbprintf(gbuff,a01 8 ,"commond--i > cgiotcp namo-i t o looation-^ ^ o phyoiocd-%o'^o primitivo-^o pid-Hd 

ppid-tXid^tnQUIT^in", oor^aoo.namc, oorviGcJocQtion, oomputcp, oorvioo, oomoojprimitivo, gotpidO. gotppidO)! 

u:0cndiKi(XiivG(tdo_(X)mputop, tdo_oci^(!o, gbuff,otrlcn(gbu^.biiffcp, & roieo) ; 

aQ.cloo f i printf(otdorp,"fiulcd to find TD S to rogiotop.\n"); 

co.(^tcp_acoopt)(Qfgo, computer, ocrvioc, oomocjooation, ocrvico.naB ae)^ 
dd,CKit(0); 

[I847].iiiui){ 

a hnndlc - d]opcn( oorvioo Jooation — NULL ? Qjgv[l] ' ocrvioojooation, RTLD.LAgY); 

b. if( ! handle ) break; 

o.if( ! oop^noo jnmo) ooFvioo^namo-af efvfe^f 

d. function ~ dlo>nii (handle, oer>aco_iuiin e)^ 

c, if( ! function ) { dloIoooChandlo); break; ) 
flrotum ((*function) (argo, orgv)); 

0 && ! oopvioojooation) ( 

a. ohor ^tdo_oomputcr->JULL; 

b. char ^tdo_ocrvioo->JULL; 

c. gct_tdo_oonnGction_info( & tdo_oomputor, &tdo_ocrvioc); 

d. if( tdo,oomputop &ft tdo_ocrvioo ) { 

c.Ghnr gbufft4Q0 6 ]; 
^e har ^bpi 

g. int PoiBC-1006; 

h. memf)Gt(buffor,'\0',roiBc); 

i. oprintf(gbufiF,"oommand~qucr3 i T namo~V 6 o'^in", oorvTiec^nomo); 

j.ifi ocndPoooivo(tdo^ooinputoP,tdo^oopvioQ,Cbi i ff, i <018>buffbp, & roiao) * ^ =Q4 

^rintf(otdcrp,"fiiilod to looato ocpvicc'^in"); rotum( ' l)r} 

a. bp^bufforl 

b. whilo(bp) ( 

i.nQmc~NU t^ 
u.valuo-NULL; 

iii. bp~(chap *)gotnvT)air(bp, & namc, fa^oluo); 

iv. ift ! name I I ! value) break; 

v. if(otromp(namo,"looation")— 0) ( 

vi. ocrvioo_looation-TnaUoc(otPlon(valuo) » l)l 

vii. otrcpy(oor>uoojocation, value); 

iK.oloo if(otrcmp(namG,"primiLiv i :") 0) { 
K.QOP^qoojrimitivG-malloo(otrlon(valuo) 4- l); 
Ki.otPGpy(oorvioojrimitive>valuo)i 

Kiii.oloo if(otPcmp(naino,"phyoioar*) — 0) 4 
iciv.ocrvioo_oonnocti%nty-malloo(otrlon(valuo) 4- l); 
jiv.otpopy(oopvioo_oomiootivityi valuo); 
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€4 

d> if(oervicc_connoetivity) { 
i.oorvicxi~oompu 
u.whilo(^OGrvico & & ^ocrvioc !~ * *) i * ocr^^GOl 
iii.if( *ocmoc ) { ^ocrvioc^'VO*; *-»- Qorvioo; ) 

£olicnt_gl3(oomputcr, ocrvioo, inputdoooriptior, outputdoooriptor); 
[l854]lnt gct_tdojonnoctioiL.info(ohQr ^^oomputop, ohor ^^oorvioc) 

[1866]4 

[l866]uinr buffcrlaOl B ]: 

*^-fopcnCVtmp/tdo" , "r") ; 

[l858]wyhilc( fbcaDf(Qj,"%o",buffcr) —1)1 

a. if(otromp(buffcp,"inct") — 0) { 

b. mcmoct(buffor/\0',a04 8 ); 
«:fee anf(fp,"^o",bu£Fcr); 
d.* ou i i Apulci ' mQlloo(otglcn(bufiFop) * l)i 
fe otocpy(*computoj,bug iBt^ 

f. incmoGtObufFop,'\0',304 8 ); 

g. fi3CQiif(^,"%D",bu£fcp); 

h. *oGPvioo m.ullo t i( u lglon(buffcr) * l)i 

i. otrcps<*oorvicio.buffor); 




[l862]ProgrQm Lioting 9.2 gonorio front ond loador Qorvico oliont_Bl.G 

[l863]//inoIudc "ocrviGoo.h" 
[l864]//acfincMx\XSOCKx\DDR 304 8 

int Qliont_gKchQr *Qrgvl, ohar ^argva, int fd_in, int fd^out) 

[l 8 67]int ooekfd- ' i; 
[l868]m(. u; 

[l870]ooclilon_t 
[l87l]otruot oooliaddr ^oq; 

[I872]« t fd_octi[a]; 
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vaid ^libhandlol 



¥eid *^ 



1876]« t (»ftmotion)antMiit<^); 



— (*gamiKOonnoot)(ohaj ^, char ^ 



1878]if( (UipUbhondlo - dlopcn(".7toombtGo.oo.l.O",RTLD,Lx\ZY)) — >rULL) { 



Q.ft)rintf(otdorj/'(ilopcn libocr^Tiooo.oo failed ormo-i 6 d'^in'\ orrno); 
b.^rintf(otdcpr,"orror condition [^ ^ ol^tn", dlorJorO): 



1 8 80]uQmix(X)nncot-dlo>Tn(toplibhiindlc, "tcp.oonn eetf^ 



a. ^gintf(otdom,"topjoonnoot mlooing^in")) 

b. ^rintf(otdon ' ,"ori?oi' condition [tto3\n", dlcrrojO): 



(function - dlo>Tn(tGplibhandIo. "toUiS")) — NULL) ( 

a. ^rintf(otdcrr,"dlo>Tn of function [^o] failed onmo-i ^ dW, "tolka". orrno): 

b. ^rintf(otdopr,"crror oondition [%o]\n", dlerrorO)! 



188 5]muinoot(iowTlinoi'\0')aO« 8 ): 



1886]if(eninuiconiicc t && ( (oeelifd"(*gttiiiinooiinoet)(MgvliQ»gv8)) — ^ ■ ! )) oidtd); 



1^ 



fcloc CHit(l)) 



[l888ls6 i-mQllocQVL\XSOCI^\DDR); 
1889]ltn-^ii\XSOCKADDR; 



1890]t ' ctpccpnamo(ooclifd,oQ,&lcn)l 




3tl[l]-dup(ooehfdD; 



189 4]fJ_uot3[Ol-dup(ooolifd); 



189€}e 

^funQtion)(fd_ootI, fd_oct2); 
1888}/^ now ohutdown, and then clooo, the oonncotor 



1899]uLuldown(fd^QOtl[l3,3); 



1900] u limjdown(fd_0Gta[0],a)l 



190l]tl o iKj(fd_octl[ll); 



1903]u u uL(fd_oGta[ol); 

1903]itluin(0)l 
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[l906]ProgrQm Lioting 9.3 gonorio front ond loador Qorvioo oliont_gl3.o 



1910]oliont_gl3(char *Qrgvl, ohor ^Qrg\^a, int fdjn, int fd_out) 



[l915]uocMon_t Icn; 
1916luU ' u u t uo ukaddj ^ 



1907]//mcludc "log.h" 
1908]//dcfino Mi\XSQCI^\DDR 301 8 



19U}4 



1914]diui ' roovlinisEaOl S ]; 



^IQiTla^^ fiLootl[a]; 



191^ 



v^d ^toplibhau MHer 



193l]mt (WfunotionXint ^, int ^)] 



(*gaiiiixoonncot)(ohar *, ohoj 



1923]if( (tcplibh i mdlo ~ dlopcn("../too/Ubtco.oo.l.O".RTLD_LAZY)) — NULL) ( 



Q.ft)rintf(otdorr,"dlopon ../tco/Iibtoo.oo failed crmo-9 ^ d\n", orpno): 
b.^rintftotdorr/crror condition [%o]^in", dlorrorO)! 

1 92 6] gQmixoonncQt~dlo>Tn(tGplibhQndlo, '*tcp_oonno et^ 



1926]if(!gQmi3toonnoot) { 



a. ft>gintf(ot dorr, "top^oonncct mlo0ing'^\n") } 

b. ftirintf(otdorr,*'orror condition [Wol^in", dlorrorO)! 



1928]if( (function - dloymCtoplibhandlc, "tedka")) — >JULL) cmt(l); 



1929] ^i^moct(rccvlino,*^^O^aO 4 8 ); 



1930]if(gdmiKconnoot ft& ( (oookfd-(*gamiiioonnoct)(arevl,apgva)) — ■ ! )) cidt(l); 



1931W 



1932] u u mallocaL\XSQCI^\DDR): 



1933} 



[lon'-MAXSOCKi\DDR; 



193 4 ] go tpccrnomo (ooGlifd,oa, fe lon) 1 



octup the oonnoctor 



1936]fd_uetl[0]-fd_ii 
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[l937]fd_ootl[ll-dttp(ooolifd); 
[l038]f(L u uia[ol •dup(oookfd); 
[l939]f i Loota[l]-^d_out: 

[l94l](^funotion)(fd^ootl, fd^oota): 

w ohutdown, and thon olooo, tho oonnootor 
[l943]ir( ohutdown(fd,ootl[l],a) !- 0 ) 

[l944]fpi ' mtKulderj,"oliont^ia: ohutdown failed orror %d\u",Oi ' i ' iio)l 

[l946]if( olooo(fd_ootl[l]) ) ^gmtf(otdorg,''oliGnt^ia- olooo fd^ootlll] failod orror-^ t dXn", orono); 
[19 46]if( clooc(fd_oota[0]) ) »rintf(otdcgp,"cliont_gia- olooc fd_octa[Q] fiulod cgror-^d^^n", omma); 



[l949]Prograin LiGting 9.4 gonorio front ond loador oorvico gl3.o 

[l950]//imaudt 

[196 include ^dlfcn.h^ 

[l963]//iu t JiudL *" ' Crmo.h> 

[l963]//inoludo ^maUoo.h> 
[I964]ffimiludu 

[l955]int gct_tdo_oonnoction^infb(ohar cb mp-*^ 
[l966]iut g HKint argo> ohop ^argvD) 

[I067lt 

v«d *handlo; 

HokqI. 
[l960]"¥< 



(*funotiion)(int, ohop ^*); 



<8id- 



»Ubthandlo; 



[1963]lLiu 

^19^^fl'8b€HP— 

[I064]ulm 

[ 1 9 6 5] oiiui'- 

[l966]Llmi - 



optXint, ohog *, chag ohar *, ohor 
buficr[301 8 ]: 



*oorvioo_nanio~>fUIJji 

*oepvioo,looation~NUIjLi 

^oeJvioojprimitivc~NULL; 



*Qorvioo_oonnoctivi<iy-^NULL r 



^oomputer'NULL; 

— woogvioo-.NUljLi 

[1070] 



^namo~NULL; 



[l97l]^a feM ttvoluo-NULLl 
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[I073]j flt p^eiaefS}; 

[l974]iKmbu 1){ 

Q.fprintf(otdoro."c^3 naino-_namo_ looation-Jooatioiu pgimitivo~_primitivo, phyoiool-jhyoioaL^in"); 
b.cidtCO); 

[l976]oGrvioo_nQmG ~ oorvTiooJooation ~ NULL; 

[l977]fog(indoK-i; indoK ^ orgol 44indoii) { 

a. namo~valuc~NULLl 

b. gctnvpQir(Qrgv[indoxli & namo, fevoluo); 
o.if(nQmo) { 

d.if(oti»cmp(nQmo,"nQmo") — 0) oorvioo_namo~v afae; 

c. cloc ifCotrcmpdiamo/'locQtion") — 0) ocCT i nccJocQtion~v^aluc; 
foloG if(otromp(namo,"primitivo") — 0) oorv^ooj[>rimitivc-vQluc? 

g. clflc if(o1iromp(naino,"phyoioQl") 0) oui ' vioo_oonncotAvity~valuoI 

h. cloo brook; 
44 

j.oloc break; 

[1978]} 

[1979] argv-~ & Qjgv[indo3t] 1 

[1980W 

"indox; 

ao oonnoctivnty io opccifiod, then wo aooumo wo 
[19 8 3]// ax. Q ocrvioo pgovidor. Wo allow two portiono in tho 
[l983]// oomicctivity opocificatdon. the firot io the hoot, and the 
ocoond io tho ocrvioo. Thio ollowo uo to uoo thingo Uk e^ 

[1986]^ m.o.o.rooo 

— Aocol - /tmp/uniicdomain^oookot 
— /fifoVtmp/nomo djipo 



/mmap7pQth/filonQ «e 



fl88^# — /phono SOO - Oad ' OT a OB 

— /omail'oj] 



ti992]« 



/pagog:600 ' 0ai'7 8 06 



/fim: 6 00'034 - 7 3 0 6 



[I093]ir(uciao 



a. oor>nQo-GomputGr-oor>iGO_oonncGtivity) 

b. whilo(*oorvioc && ^ocrvioG !-':') -t - i- oor^Ti , 
oM ^ocrvioo ) ( ^oogvioo~'^iO'; 1 ' oorvioc; ) 



[1994]» 

when tho oommand lino oontoino an INET opooifieation, feg4be 
[l996l// pi ' imiUvo, wo automatically gogiotor tho oorvioo with tdo. 
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thio io an implomontation : 
oomputop && ocrvioo && 



lOOUO. 




ft& otiKmpCocpvioo jgimitivo/'INET") — 0) 



a. UbthQndlo - dlopon("libtco.oo.l.O".RTLD^\ZY)l 

b. if(!Ubthandlo) { 

o^^rintiffotdciT/'oonfigujation ojjop on TC S ^ji")j 
d.^rintf(otdon*>"orpor condition' %o^in",dloiTOpO)l 

0. cxit(l)? 

g. tcp_QGCopt-dloymQibthandlo,"top_aooopta"); 

h. if(!tcp_aoccpt) { 

1. ^rintf(otdcrr,"TC S oonfigujation cptop for oupporting routinoQ,\n"); 
j.cidt(l); 

l.if( otroaoccmp(oGrviGO_namc,"tdo") — 0) { 

m.void - ^hondloi 

n.int (*tdo)(int, char *); 

o.FILE ^^»-fopcn("/tmp/tdD'\"Q"): 

p.^rintf(Q)>"inot %o %o^in", oomputcr, ocrvioo); 

q.fclooo(fp); 

r.handlo-dIoponO'../tdod/libtdo.oo.l.O",RTLD_IiAZY); 
0 i f( hnnd lr ) { 



Lohor buflrcr[a04 8 l; 

ii.ofoprintf(buffcr,aO 4 8 , "command-query namo~tdo'^in"); 
ill. tdo-dloym(handlG,"tdo") ; 
iv.if( tdo ) (*tdo)(0,bu£fcr); 

%ndlGlooo(hand i o) i ' 



u.oloc ^rintftotdorr/'on n not find libtdo.oo.l.O^in"); 

y.ohar gbufft3018l; 

B.int (^tdo)(int,QhQj*); 
aa.void ^hondlol 

bb.handlo-dlopcn("../tdod/libtdo.oo.l.O",RTIiD_IiAZY); 

oc.ofbprintf(gb\iff,30'18,"commQnd-rogiotGP namo-^l"9 ^ o' ' ^" locQtion-^/'%o^i" phyoioal-^"%o:%oV primitivo-^i"^o\%nQUn^in"> 
ocrvioc.namo, ocrvioo_looation, computer, ocrvioo, oorvioo_primitivo); 



oooago(gbuff,0): 



■if( handle ) { 



i.tdo-dlo}Tn(handlo,"tdo'*); 
iv.Q)rintf(otdorr,"miooing td s; 



[%o]^Ji", dlorrorO); 



v.Gidt(l); 




ta001Jl o g_f.mcooago("attompting to rcgiotor 
[3002]l u gJ.moooagG(gbufF.O); 
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i. (^tdo)(O,gbu£0: 

ii. olooc (handle); 

ft)irintf(otdori' "cMxnnot rcgiotor oorvioo. miooing libtdoVn"); 
b.(^tcp_QOOCpt)(argc, oomputor, ocrvico, oorvico_locQtion, ocrvico^nflmo); 

Q.handlo ~ dlopon( oorvioojooation — NULL ? Qrgv[l] : ooFviooJooation, RTLDJjAZY); 

b. if( ! handle ) break; 

c. if( ! oorvioc_namc) oorvico,namc~arg^T[a] ; 

d. function ~ dtoym(handlO| oon i noo_nQmo): 
o.ift ! function ) { dIoloocOiandIc); bj eefe^ 
f.gctum ((^function) (argo, ar^v))'f 

or%Ticc_namc && ! ocr%iocjocation) ( 

a. FILE *^-fopen(7tmp/tdo","r'0: 

b. whilo( fiacanf(»,"Mo",bufEDr) — 1 ) < 
o.if(oti!cmp (buffo r/'inot") — 0) { 

i.nicnioct(buffer/\0*,a01 8 )) 
jfcfee anf(^,"%o",bu£for)} 

iii. oomputcr~malloo(otrlcn(buffc j) * 1); 

iv. otropy (oomputor,bu£fcr) ; 

v. mcmoct(bu£EDg,'V0',a04 8 ); 
W.fiacanf(^>"%o",buffer); 

vii. ocr\Ticc-malloo(otrlcn(buffcr> *4); 

viii. otrcpy(ocrvioo,bii£Fcp); 



4:^ 

f. if( oomputog ft& ocrvioo ) { 

g. int fdol[2]; 

h-int fdDa[a]; 



}:eh€B*J*bpJ 
Ii.Ghar gbuff[204 8 ]; 
l.pipo( &fdDl )i 
m.pipc( fefdoa ); 

n.oprintf(gbufi^"oommand~quory namo~%o'^in'', oor^doo.naa e)^ 

[3008]lmuf.moooago("oonding POquoot".0)l 

cooQgo(gbuff,0); 
aM writc(fdol[ll,gbuff,otrlcn(gbu£D) !- otrlcn(gbufD) 

i.ft)gintf(otdopp,"wgito to pipo failod ogpno-%d^in", ogmo); 
b.clooo(fdol[l])i 

cohont^Koomputor, oorvioo, fdolIOl, fdoa[l]); 
d.loe_f.moooago("oliont_gloomplotod",0): 
o.oot_nonblooliing(fdo3[0]); 
f.mcmoot(bufifcg,'\0',a04 8 ); 
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g. rGQd(fdo3[0],buffcr,a04 8 ); 

h. log_f.moooQgo("rcoponoc iQ",0); 

i. log,f.moooagc(buffop,0); 
j.bp~bufforI 
k.whilo(bp) ( 

i Tinmn->TTTTiTi- 
ii-vduo-NULL; 

iii. bp~gotnvi)Qir(bp, & namo, & valuc)j 

iv. ift ! naino I I ! value) bjoakl 

v. log^.moooago("pgoooooing iiQmo",0); 
w.log,f.mcooQgc(namG,0); 

vii. if(otrcmp(nQmo,''looQtion") — 0) ( 

viii. ocFviooJooation ■malloo(otglcn(vQluo) * l)l 
iM.otropy(oogviooJooQtioii, value); 

XLOloo if(otgcmp(iiimio,"priniitivc") 0) ( 
Kii-ocrvicio jrimitivo mull iH j( o Lrion(valuo) -*- 1)1 
xiii . otropy(oorvioojpgimitivo, value) I 

KV.cloo iftotrompduunc^^phyoical") — 0) { 
im.oorvioo_ooniicctivity~malloo(otrlcn(value) * l)? 
Hvii.Qtrcpy(ocrvioo_comicetivity, value) i 

in.clooc(fdol[Ol); 
n.clooc(fdolIl]); 

p.ciooo(fdoa[i]): 

q.if(ocrvioo_ooniioctivity) { 

i. ocrviee-oomputop-oopvico_ooimeotmty; 

ii. whilc(^ocrvioo & & ^ocrvico !~ "') < < ocrviooi 

iii. if( ^ocrvioc ) { ^ocrviGC~"'iO'; t t ocrvioc) > 

o.cIqo log_f.nioooago("miooing ocmoo ooimeotivit3 i T",il); 
t.clicnt_gl(oomputog, oorvioc, 0> 1); 

[3011]ittuiii(o)i 
[3013]} 

i got_tdo,oonnootion^info(ohag ^^oomputor, ohor **oorvio ^ 

[301 ll< 

buffiirfaotf]; 

*^-fopon('Vtmpftdo'',"p''); 

[3017] wliile( fixiaiif(»/W.bufiFog) — 1) ( 

a. if(otgomp(bufFor."mtt") 0) { 

b. mcinoot(bu£For,'\0*,a04 8 ); 
64i9e anf(^,"%o",b «gei4^ 
d.*oomputoi ' mall o o(otglcn(bufifcp) » l); 
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o.otropy(^Qoraputor,buifor)i 
f.mcmoct(bu£for,'^^0'.a01 8 ); 
gAe anf(Q),"%o",buffor): 

h. ^ocrvioc-malloo(otplon(bufiFop) * l)] 

i. otrcpy(^oorvioo,bufFor) 1 

FftOiftl M 



[302l]Program Liotdng 9,5 gonorio front ond loador oorvioo oondroooivo.G 

[2023] //inoludo '^otdio.h^ 
[2023]tfiimlmlc ^limito.h^ 
[202d]ffiiicludo 'iormo.h> 



i oondmooivofchog *oomputop, ohop ^oorvicw, ohog ^roquoot, int oieo, char *rooponoo. int ^goinc) 

^02^ 

[3028]mtfdui[a]; 
[3029]mtfJua[al; 

[2030]mtii; 



[2032]dmr gbuff[PIPE_BUr]; 
[2033]l o B,f.emoj("ocndi'oocivc",0); 

[2034]if((!oomputcp) I I (loorvioc) I I (li - oqucot) I I (loiBo) I I (Irooponoc) I 1 (Iroiiio)) { 
Qlog-f.moooQgc("bQd poromotopo", ' ! )* 
b.log_f.GKit("ocndPOCoivo", ' l); 
o.POtupn( ' I); 

[2036]ir( o iao > PIPE_BUF) { 

Q.log_f.moooQgG("oond moooago ^ PIPE JUF oigo", ' l); 
b. log_f . 03ut("ocndrcooi vo". ■ l) i 



{203^ 
[2038k pipu( 

Q i log^fnicooQgGC'out of rcooiipooo"i ' l ) ; 
b.log_f.ciiit("ocndroooivo". ■ 1): 
o.POt i UPn( ' l)l 

[2040]ir(pipo( ft fdo3)) ( 

a.olooo(fdol[Ofti 
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b. Qlooc(fdol[ll): 

o.log,f.moooQgoC'out of pooouroco", ' l)i 
d.loeJF.cxit("oondgoooivo", « 1); 

c. gctum('l)i 

[3041]» 

ritc(fdol[l],PoqiiGOt,oiac) !- oigc) < 
Q.^riiitf(otdorr,"writo to pipe foiled ormo-^ ^ d^m", crmo) ; 
b.olooc(fdol[0]); 
o.Glooo(fdol[l]); 

d. olooc(fdoa[0]); 
o.olooo(fdoa[l])l 

f. loe-f-moooago("writc to pipe failod",ormo)l 

g. log_f .C3iit("oondKiOoivo'', ■ 1)? 

h. rotxim( ' l); 

fon>i>i1 [,1V 

[3045]oUont^ia(oomp utcr, ocrvioo, fdol[0], fdo3[l])l 
[2046]u-pcck(fdo2[03)l 
fe04 ^ n ^ ^Toima ) n-*roiBOl 
[3048]memoct(gooponDC,'^lO^*gQiBo)l 

[3049]nuiiiu o; 

I 0 && pco]i(fdo3[0]) 0 ) ^roifflO-roQd(fdo3[Ol,i!OOponflO,n); 
[205l]d o ut(fd u l[0])l 

[3063]u uu c(fdua[o3); 

[3053]uooc(fdo3[l]); 
[2064]l o g,f.muuoagc("noimQl roturn'',0); 
[2066]log_f.ejiiL("oondi'oooivo",*roii5o); 
[3066]ittum( 



[2068]ProgrQm LAoting 10,1 thread oonnoctaon oorvioo " talkS.c 

|3Q60 kncIudo.otdio.h^ 
[3060]tfinoludc ^Qtdlib.h> 
[306l]tfiu u luJL ^oyo/ocloot.h - "* 
[2062]//includo ^oyo/timo.hft 
[2063]//moludo '-dlfim.h^ 

[2065]mt talli3(mt »fdl_oot. int *fd3_oot) 

[3067]ia_uut 
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nfdo. g; 

admmfd"'!? 
[2070]otiyuot timovQlt> 
[307l]i at (*fimotioii)(void)-NTJLL; 

timcout~10; 

[2073]jucinoGt( &t, '^lO', oiBoof(otiniot timoval))! 

[2074]if((fiinotion - dloym(NULL."BOt_too_tiinoout'')) !- NULU timoouti - (*function)0; 
[2076L ■tv_ooo ~ timoouti 

[2076]if( fda_oot — mJlAj ) whilc( pQrtioipant(fdl,oot[0]>fdl,oot[l])>0) I 

l2QW jolQ0whilc(l){ 

a. t.tv_oco ~ timcoutr 

b. FD_ZERO( &KiQd_fb ): 

c. FD^gERQ( & OOTOg,fb }'> 

d. nfdo-0; 

0. 1f(fdl_oct) { 

£FD_SET( fdl_oot[0], ft gcodjo )l 

g. FD_SET( fdl_oct[0], & on'ogJb ): 

h. nfdo-fdl_oct[0]l 

j.if(fda_oct) { 

k.FD, S ET(fda_oct[0], & road_fb)) 

1. FDJBET(fda_oot[0], & 0CT0g_fb); 
m.if( fda_oot[Ol ^ nfdo ) nfdo-fd3_ootl0]l 

o.ifOnfdo) broolil 
p. I » nfdol 

q.if( (r-oolo(rt(nfdo, & iHiQd_fb,NULL, & ogrop_Jb, & t)) 0 ) gcturn( ■! ); 
r.ift r — 0 ) brook; 
o.if(fdljot) ( 

tif(FD_I SS ET(fdl_oot[0], & rcad_fo)) ( 

i. iiitt-pQgticipQnti(fdl_oct[Ol,fdl,Qct[l]); 

ii. if(t ^- 0 ) ( ohutdown(fdl.oot[l],I); fdl_oct->r[JLL: > 

v.cbc if( FD_I SS ET(fdl_oot[0], & cmop,fb)) broak; 
ii,if(fdfl_oot) ( 

y.if( FD_J S SET(fda_oct[0], & roQd.fb)) i 

ii.t-pQgticipant(fda_oot[0],fd3_oct[l]); 
iu.if( t 0 ) ( ohutdown(fda_oct[l],0); fd3_oot-NUIiL; ) 

aa.cloo if( FD JSSET(fd3_oot[0l, & 0CT0P_fo)) brook; 

[207 8 ]» 

[a079]ioiuiu(o); 
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[208l]ProgrQm Lioting 10.3 throad oonnootion oorvioo ■ participant.o 

[3083]//inoludo ^otdio.h^ 
[3083]//mcludL 
[3084]//mQludo '^fcntl.h^ 

porticipantdnt fdl, int fdS) 

C3087]otatio ohoF *buffoP r 

bnfGpr_oi ge; 
fe088 ktn-T)ock(fdl); 
[aOQOliutni; 

[30Ql]if(! buffog_oigo) { bu£fog_oiB0-100 8 ; buffor-Cohor *)maU ( 

Ia093]ii(u o){ 

Q.iK n ^ buffcr.oiBO ) { 

b. if(buffor) frooObuffor); 

c. buffcr_ox B C~n * 1 j 

d. bufier-(chQr ^)mQlloo(biifEDr_oigo) ; 
f.DicmQot(buffcr>">iQ',buffop_oii5o) i ' 

h. n-rGQdn(fdl, buffer, n)l 

i. if(n — 'l)poturn(O); 
j.ifdi — 0 )gotum(0): 

[3093] wi ' i U mmjuiii' 

Q.ormo-0; 

b.nl-writon(fda>buffor,n); 
o.if(nl !-n){ 

d.if(nl — ■ ! && ogpno — EAGAIM) ( 



Li.fd^oot writio_oct, oiTOg_oot: 
y.nfdo-fda -t- i; 



v. FD_ZERO( &writo_oot); 

vi. FD_ZERO( & on'or_oot)j 

vii. FD, S ET( fda, & writo_oot): 
% Tiii.FD_ S ET( fda, fecrror^oot); 

iK.ir-ooloot(nfdo,>njLL, & writo_oot, & OCTOgjrot,NULIj); if(p — 1) ( 

H.if(FD_I SS ET(fd3, & writo,DOt)) goto wpitonagain: 

jdi.oloo if(r — ■ ! && crmo — EIOTR) goto writonagain; 



[3094]} 
[3096]ici,uiii(i i ); 
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[2097]ProgrQm LAoting 10.3 thread oonnootion oorvioo " tGp_aocopt2.c 
{2088} 




[2103]//inoludo ^oyo/tiimo.h-> 
[2104]//moludo <fontlA-> 
[2105]tfmuludu 
[2106]tfinoludo ^notdb.h-> 
[2107]tfiiioludo *^dlfon.h-> 
[210^^iBfc 

ooptadnt orgo, ohar ^oomputor, ohm ^ocrvioc, ohop ^ocrvioo Jooation, ohap *oorvioo_nM i^ 

liotonfd; 

Qdminliotcnfd"' 1 i 



oonnfdj 



[211 4]oocklcn.t addrlcn-0, lonl 
mot oookaddr ^^oliad di^ 

[2116]4iijmii_l tidte; 

[2117]« bag bugl3Q4 8 ]: 

veid ^libhandlol 

(2X10] 111b (*fimotion)(int,void *)l 

^2 1 2 0] int (^timoout_fuLnotion)(void) ~ >fUIjLj 

[212l]j Bt (*Qdininfunotion)(mt) -NULL; 

[2 122] ml *timoout^valuo; 

l2123]»t *e=e; 

(libhandlo - dlopon(ocr^dcicJooQtion.BTLDJiAZY| RTLD,CLOBAIi)) — NULL) { 

a. ohag ^op-dlorrorO; 

b. Q)rintf(otdcCT,"dlopon tto foiled ommo-ttdViii'', oogviooJooation^oPPB ^ 
c^rintftotdogp, "error mcooago [Hol^ ' in", op); 

12126}} 

[2126]if( (fimotion - dlo^TnOib handle. ocrvioo.namG)) — >ry iJ:^ 

Q.^rintf(otdorr,"dloym of function [%o] failed crrno-%d\n", ocrvioc, crrno): 
b.ft>rintf(otdorp,"oorvioo not avoilablo^in")! 
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[3137]} 

[2138] up i ' mt l) fl i) uff;''%ojamoout",oorvioo_namo); 
[3 139]limtouli Junction - dloym(libhandlo,bu£Df 

intfCbuff, "%o_timoout_vQluo",ocgvioo_naine )? 
[313l]limuout_valuo ~ dloym(libhandlo,bu£Df 
[3 1 33]oppintf(buff.''%o_Qdmin"^oorvioo.iM Haae); 
[3133] udmiufunction~dloym(libhQndlc,bufl); 

)tgcmp(oomputcg,"") — 0) liotonfd ~ topJiotcnCNULLi ooFviooi fe addjlon); 
liotonfd - top_liotcn(oomputc>, ocrvioo, feaddjlon); 

mQlloo(Qddrlon)l 
Q.otruGt timo¥altff 



c. fd^oot rcQd_oct, writo_oct, crror^oct; 

d. momoct( & t, '\0\ oiiicoftotruct timovol))! 
c.mcmoot( oliaddf, '\0\ addrlon)! 

f!.t.tv_ooo ~ timoout_vQluo ? *timoout_valuo ' 8 0; 

g. FD_ZERO( &rGQd,oct ); 

h. FD_ZERO( &writc_oct ); 

i. FD_ZERO( & cmror_oot ); 
j.FD,SET( liotonfd, &roQd_oct )) 
li.FD_ S ET( liotcnfd. fe crror^oot ): 
Lnfdo-liotcnfd; 

ia.if(Qdminfunction && adminliotcnfd ~ ■ !) 

n.adminliotonfd-(^QdniinfiuiGtion)(0); 

o.ifCodminliotcnfd^ ^ 

p.FDj B ET( Qdminliotonfd. A road^oot); 

q.FD_SET( Qdminliotonfd, & orror_oct ); 
f: afd0~nfdo » >QdminUotcnfd ? nfdo ' adminliotcnfd; 



u.ir-ooloGt(nfdo, & goad_QOt,>rULL, fe crror^oot, & t); 
v.if(r^O)( 

w.if(cpgno — EI>rrR ) oontinuol 

M.fprintf(otdcrr,"ticp_QOOOpta' ocloot foilod crmo' %d\n",OFrB e); 

y.cxitd); 

QQ.if(p — 0 ) { ifttimcout.function) (^timoout_funotion)0; oontinuol ) 
bb.if( adminfunotion && Qdminliotonfd 0) { 
oo.if( FD J S SETCadm in l i otonfd, ft gcad.oot)) { 

i. oonnfd ~ Qoocpt(Qdminliotonfd, cliaddp, fe lon ); 

ii. if[oonnfd — ' 1)1 if(crrno — EINTR ) oontinuo; bjoak: } 

iii. go-(*adminfunction)(oonnfd ); 

iv. ohutdown(oonnfd ?3); 

v. olooo(oonnfd); 
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vi.ifOro) bjookl 

ff.if(FD,I SS ET(liotonfd, &rGQd_oct)) ( 

gg.oonnfd ~ QOOcptUiotcnfd, cliaddp, &lcn); 

hh.if(ooiinfd — ■ ! ) { if(o«mo — EINTR ) oontinuo; fagoaki ) 

[313Q]{ (*funotion)(oonnfd,oliaddp); ohutdown(ooiuifd,a); cloooCoona a)^ 

i. tioko-tmio(NULL); 

ii. oprintf(buf^"%.31o\n",otiinc( ft tioka)): 

iii. writofoonnfd, buff, otrlonCbuflD) j 

iv. ohutdown(ooimfd 78)y 

v. olooc(ooiM aii^ 



[314l]ittuiii(iu)i 

[ai43]» 



[2143]ProgrQm Lioting 10,4 throad eonnootion oorvieo • tcp_GonnoGt,c 

[2 1 45]int t i Op_oonnoct(conot char ^hoot, (Mnot char i*oorv) 

[3148] o U ' uul addrinfo hinto, ^rco, ^poooqvo; 

[2149]bBcro(&hinto ,oii! i Gof(otruct addrinfo)); 

[3 160]liintQ.ai_family-i\F_U>JSPEC: 

ii_ooclitypo-SQCK_ S TREi'\M; 

-gctaddrinfo_gami3i(hoot, oorvT, fe hinto, & rco)) !- 0 ) ( 
Q.^rintf(otdorr,"tiCp_connoot: gotaddrinfo foiled crrno-^dW, crmo )^ 
b.oiiitd); 

[2 1 5 4] tfCSOQVC^rCOr 

fe4§^de ( 

a. oockfd"'oookot(rco ' ^ai_fQmily, poo ' ^ > Qi_oockt3 i T)C, poo«>aijrotocoD? 

b. if( oockfd 0 ) oontinuo) 

c. if( oonnoGt(oockfd,PCO'?*Qi,addp,goo ' ?>aLaddrlon) — 0) broak: 

d. clooc(oockfd)j' 

^hilo( (rQO~rco ' ^Qi_ncKt) !- NULL); 

[2167]ifaoo — ^^ULL){ 

a.^rintf(otdorp,"top_oomioot orror for %o. ^o' ^ in", hoot,oorv)l 
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b.rotum( ' l); 
i tumCooolifd): 

[3161]» 



[2163]Program Lioting 10.6 throad oonnootion oorvioo • topjioton.o 

[2164]#moludo *sumotd.h = ^ 
^noludo ^otdlib.h?** 
[2 1 66] //include ^oyo/typoo.hr* 



[2168]//mcludc ^fontLhr^ 
[3169]//mUudL 
[2170]//includG ^nctdb.hr> 
[217l]//ixicludo ^ ■ dlfcn.h^ 
[2172]//if ! dcfincdaJ S TEMQ) 

[2173]//dofinc LISTEN Q 

f3174l/n.LJif 

[2 1 76]lcp JiotonCchor *hoot, char ^oorv, oooklcnj i ^addrlonp) 

[3177]^ 

[2178]mt liotonfd, n; 
[2 1 79]conot int on-i; 
[2180]otruct addrinfo hinto, ^roo. ^pcooqvc) 
[218l]bacro( & hinto, oiaoof(otruct addrinfo)); 
[2182]hiiito.Qi_flQgo -i\I_Pi\g S I\^I 
ii_fdinily- AF.UM S PEC; 
ii_ooclit)'pc-SOCK- S TREAI > i; 
gctQddrmfo_gQmiK(hoot, - ocn p ', & hinto> & rco)) !~0) 
fiprintf(otdorp,"tcp_liotcn: gctaddrinfo failed crmo~%d''in", crrno); cxitd); } 

{2187^ 

[2X88]du 

[2189]< 

a,liotoiifd - ooohot(peQ ' ^Qi_fQmily, goo ' ^ai,oooktypo, roo«?*Qi_pgotiOool); 

b:if( listcnfd 0 ) oontinuol 

c. ootoocliopt(liotcnfd, S QL.SQCKET. SQ,REU S EADDR, & on, oiBCof(on)); 

d. if( bindOiotonfd, gco ' ^^ai.Qddj, ^oo ^ ^>ai_addrlcn) — 0 ) brcQli: 
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[3 190]) whilo((pooTOO ' >ai joict) !~ >rULL )l 

[ai9l3if(i«oo — >aJLL)( 

Q.^rintf(otdorr,"tcp_liotion: error for %o, ^o'^vn", hoot,oorv); 
b.CKit(l); 

^19^ 

[3193]liiJbcnQiotGiifd.LI S TENQ); 
[3 19 4 ]iiXuddi ' lcup) T^addrlonp-goo ' r*aLaddglon; 
[3 196] li' CiCuddi ' info(gcooQvo)i 
potumOlotcnfd); 

^19^ 

[3198]ProgrQm Ldoting 11,1 oupporting functiono - roapor.o 

[3199] // Uiuludo ^oignal.h > 
[3300]//muludu ^oyo^t i ypoo.h> 
[330l]//moludcj 

fOQpcrftnt oigno) 

[330ili.iJ_inia:mtuiut: 

[3205] i i>lulo((pid-waitipid( - l. a otat.WNOHANG)>0) i 

[33^)^^)F6tHfSr 

{220^ 

[220 8 ]ProgrQm Lioting 12.1 oupporting oorvioo ^ OQt_oorvioo.o 

{220^ 
[3310]^ 

[32 1 l]//mcludo ^oiTOO.h> 

[3313]iiit 

[3313]uQt,oorvioc(int argo, ohor *^ajg s4 

{331^ 

[3316]mb lu fd[a], fdi-^. fdo-1. didopon-^l 
[33 16]tjliup biiffrr[fln48]i 

[3317]burroi[o] ^o■I 

[33 18]if(urgv — NULL ) ( fdo-orgc; 

Q.n~roQdlino(fdo,buffor,aO 4 8 )l 
b.if(n^^O)buffGr[n ^ l]-'^.0'; 

cloo otrcpy(bufiFcr, Qrgv[l]); 

[3330]lf((fdi-opcn(buffcr,O.RDONLY)) ^-0 ) { fd[0]-fdi; fd[l]-fdo; -t - i- didopcn; ) 
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[333 l]mika(fd,NULL); 

[3338]if(didopon) olooo(fdi)i 
[3333] i' o><m ' u(i i ); 

[3334]} 

[3335]Program Liotiing 13,3 oupporting oorvioo " ooho_oorvico,G 

[3337]//moludc '^fcnlt.h^ 
[3338]#iiioludo ' ■ oranoj ' h?^ 



aoho_oorvioo(int fd) 

[3231 Wtu; 
[38333u i iM i buffbriaoi B i! 

) if( (n'->ott(Uiiio(fil)bufE)>,301 8 ))<^) wtvumi oloo writenftithuffofiii): 
[2334]iuHuu(0); 

[3336]Program Lioting 13.3 oupporting oorvioo - dQytiino_oorvi ee;e 

[3237]//mcluJ. ^ u lJia.h- 

42238]^ 

[2338]juylmio_OGrvTiGc(int orgo, char **Qrg\0 

[3340]^ 

[334l]limc_l ticko - timc(NULL); 

^ 

[33433i Bt fd_out-o; 

[3344]oiiui — 

Qpgv — NULL ) fd_out-Qrgc; 
[33 463oprintf(buffor,''0 6 .a lo\n", ctuno(&ticko))i 
't334'?ift^ writo(fd^out,buflfog,otglon(buffog)) I 



£324^ 

(3360]Program Listing 12.4 oupporting oorvioo • koh_oorvioo.o 

[3363];/iiioludo rtoyo/iootl.hr' 
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[3263]tfim i iludu rtuiiiotd.h > 
[2364]//moludo '^dlfcn.hN 
[2265]ffiAmludo 

[2267]kolLOcmc»(int fd, ohoB i^argvO) 

^hondlo- dlopon(".mboorviooo.oo.l.O", RTLDJiAZY); 

|226e]«« ('^oigo)(int.voidi^); 

■[ 226l]int fdJn-O; 

[2 2 6 2^41^ fd_out-li 
[2a63]iutfJ_u i a; 
[236 lluiMu buffcriaois]; 
[2266]tiiui u 

[2266]ohQr *n. ^ 

[3267]mi ui; 

didfi»li-0; 



^phyoical~NULL; 
*p rimitivo-NULLl 



[2373]e 
(22?^^i4=^ 

[2276]if( urgv — >njLL ) { 
afiUn-fdl 
b.fd_out-fd; 
o.fd^crr-fd; 
d.if( handlo ) ( 

o,if( (oiBO-dloym(handlo,"oiB.ohild"^ 44 
i.oignal( SIGCHLD, oigo); 
u.pid~forkOl 

iii. if( pid !" 0 ) { dlcloooQiandlo); rotumCO); } 

iv. I I didfork: 

U 

h.cloo ft)rintf(otdcrr,"do not havo a hondloVn") ; 

[2277]} 

[2278]tloo »rintf(otdoCT,"argv io NOT nuUN.ii"); 
[2279]//ifdofinGd(TIOCSTTY) 

[2280]if( iootl(fd.TIOC S TTYt(ohar *NULL)) — ■ ! ) rotnunODl 
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[3383]dutm u ii(1.0); 

[3383]y>iiiiL(i) ( — 
[3384]dupQ(fdju.o); 

Q.dup3(fd_out, 1); 

b. dupa(fd^crr.3); 

o7/ given oomo oritoria of what wo wont tho mail 

d.// oci^^ec to do, ogg if thoro io a rogiotcrcd oci^aGO. 

c. // typically, thio would mean wc got oomcthing liko ' 
M ^Qino-"Charloo Northrup" oonipQn3r~"Global Tcchnolo fflee^ 

g. // and tdo would fino the cmail-id. 

h. mGmoot(oi ! itoria,'\0',aO 1 8 )? 

i. m-roadlino(0,oritoria,a01 8 ); 
j.if(ni ?^ 0 ) oritoma[ni ' l]-^iO'; 
k.cloo broolil 

Lmomoct(buffor,'^iO',aO 4 8 ); 
ni.tdo_qucry_p(oritoria,bufibr,a(M 8 )j 

n.tdo_got_nlpp(bu£f ' cr, fe nomo, fe location, & primitivo, A phyoioal, NULL, >TTTT i T i )l 
o.cxoolp("koh"/'/bin/Iioh",NULL,>njLL); 

[3386]iB Oidfbrk ) oiiit(0); 

[33 8 7]. 
^388^ 



[3389]ProgrQm LAoting 13.6 mail oorvico • mail_oorvioo. e 

[3301L 
[3392]^ 

[3393]tfinoludo '-dlfon.h' - 
[3394];;mciudu ^ ■ oyo/oignol.h?* 

mQil_oogvioc(int fd, char ^org yB) 

[3397]^oid *handlo- dlopon(".flibooFvioco.oo.l.O". RTLDJiAZY); 
(*oigo)Giitt¥oid *)i 

[3399]iiitta_m o; 

[3300]mLM_ u ut i; 
[330l]uu.fd-ui a; 

bufieriaoi g ]: 

oritoria[a01 8 ]; 
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[33051 ILL ui 

didfopk-O; 

[3307] o iiu. 

[3308]uuu *phyoioal~NUIjL; 

[3309] u bui 

[2310]ulmp ftnnmn-MTIT .T. T 

[3311W 

[3313]tliQr *Qrgfva[ 8 ]; 

[3313] p id,bpid; 

[3314]ijXurg%i — I > JULL)( 

Q.fd_out~fdI 

b. fd.u - i - fJl 

c. if( handle ) { 

d. if( (oigo-dloym(hQndlo,"oig_ohild")) ) ( 

LoienaK STnCHT.D. nigo); 
iijpid~forkOi 

iii. // if wo arc tho pof cnt, thon 

iv. // clooo the handle to the lib and 
V.// poturn. 

vi.if(pid !-0) 

vu.{ dlclooo(handlc); retum(O); } 
viii. I I didforkl 

U 

gxtoo ft)rintf(otdorr,"do not have a handlo'^in"); 

o ^rintf(otdcrr,"ai ' gv io NOT niUl^in"); 
[3 3 18]ffif dcfinodmOCSTTY) 

[3310]if( ioctl(fd,TIOC S TTY,(ohar *>fULD) — ■ ! ) rotugnODi 

2 0] ondif 
[333 l]daOJ3E ion(1.0); 

[3333]^>Mt(i) 

{333^4 dupa(fdjn,o)i 

a.dup3(fd_out, 1); 
fa.dupa(fd.orp.3); 

oM given oomo critopia of what wo want tho mail 
d.// ocrvice to do, oco if there io a rogiotopod ocrvioc. 
Q.// typically, thio would moan w^o got oomcthing like' 
^tf.g flmc-"Charlco Northrup" company-"Global Tcchnologioo" 

g. // and tdo would fino tho omail ' id. 

h. momoot(QPitoPia,">iO',304 8 ); 
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i.ni--rcQdlino(0,critoria,304 8 ); 
j.ifCni ^ 0 ) { GmtGriQ[m - l]-*\0'; ni": } 
h.if(m — 0 ) broali? 
l.mcmoot(buffcp/\0\30 1 8 ); 
ni.tdo_quor3 i '^j)(oritcPiQ,bufFcr, 20 4 8); 

n.tdo^t_nlpp(bu£Fcp, fenomo. fe location, fe primitivo, fephyoical, NULL, NULU ; 

o.whiloC primitivo && phyoiool ) { 

p.if( otrcmp(primitivo,"cniQil'*) !~ 0 ) break: 

q.CKCclp ("niQil","mQil">phyQicQl, >JULL) ; 

[2326]if( didfork ) CKitCO); 

[3326]i ' ct\ifn(o); 



[332 8 ]ProgrQm LAoting 13.1 TDS oupporting functiono - tdo_quory_j).o 

[3330]//mcludo ^-rcrmo.h^ 
[333l3//mcludo '^malloo.h-' 

[2332]G3rtiom ohoj ^gotrnTpaipCohop char **, ohog ^ 
[2333]iiit tdo_gct_nvpcup(ohQP *anowcp, chap ^ncuno, ohop value) 

[3331]4 

[2336]tii l luugth-otrlcn(anowop) * i; 

[3336]uLm^uii.^ .i. ! 

[3337]uLm *u. "y; 

^33^ 
[3339L 

[23 403momcpy(alt,aiiowop,Iongth " 1); 
{234l]«^=akf 

[2343]^ 

a. n--v-NULL; 

b. cp~gctn> i TPQ_ir(cp, &v)i 
o.if( !n I I !v ) broali; 
d.if(otPcmp(n,nanio)= Q) { 

[3344]ir(yaimj){ 

[2 3 46]^valuo-malloo(otPlon(v)* 1); 

i. incmoct(^valuo,*^tO',otplcii(v) * l)l 

ii. momopy(*valtt0,%%otplop(v)); 
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[2346]} 

[2347]iitu(uiL): 

{2348}} 

[2 3 4. 9] int tdo_gGt,nlpp(chQr *aiiowcr,chnr ^^^namc, ohor i^^locQtion, Ghnr *^piiinitivc, char **pfayoicQl, int *argo, ohag ^^argo) 

1233^ 

[3362W«u,^>; 

naUoo(otelon(anDwcr) * l)i 
[3364]uU ' cp> ' (g,anowop); 

[2356lup e; 

[2366]y^liUu(ffcp) 

|23§^ 

a. n-y->nJLL; 

b, cp~BOtmT)air(op, & n, & v); 
o.if( !n I I !v ) bpoah: 

4;tf(- naino & & otpomp(n,"nainc") — 0) 

»namo-inQlloo(oteIon(v) * 1); otgcpy(*namo. yV A 
a.cloo ifQooation && otgomp(n,"locQtion") — 0) 

^3§^ *location-malloc(otrlcn(v) H); otrGpy(*looation. ¥); ) 

a.cloc ifCprimitivc && otrcmp(n,"primitivo") 0) 

*primitivti uialloo(otrion(v) 1 1); otrcpy(^primitivo, -^^ 
a.oloo if(phyoioal && otTOmp(n,"phyoioal") — 0) 

[336l]{»pliyui u ul malloo(Dtglcn(v) * l)l otgopy(*phyoioal, v); ) 
a.cloo if(argo && otJomp(n,"Qgg") — 0) 
hA 

er^ fti ' ^p mulloo(otglcn(%0 * l)! 

d.momoot(p>'\0\otrlGn(v) * l): 

0. momopy(p, v,otrlon(v)) ; 

f. if( ! argo ) 

g. { argonmalloo(oifiOof(ohni' *)*10)l inomoct(argo/\0',oi g cof(ohap *)»10)l} 

h. if( ! orgo ) 

1. {m ' BO jnalloo(oi i 50of(int)); *Qggo-0; ) 
j.aggo[*apgo]-T)I 

k. * ♦ (^apgo); 

12362}} 

{236^4%^^ee(g); 

12366}} 

1236^ i tdo^qucr}^ j(ohag ^oritoria, char ^anowofi int anowoi ^jaa^ 
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[3368]riLc^fp rfopon(7tmp/tdo","r"); 
[3368] u lim ' ^uomputcr^NULL, ^oorvioo^NUIfc 
[2370]chap bufifog[3Qd 8 ]: 

3 fijot Qooumo that if a tdo io running, it hoo tho 
Idcntifiog info in tho /tmp/tdo filo. thio o e%d4 

moved to /var/adm/tdo for oonoiotcncy acroooiinploincntationo, 
that io on implementation detail. 
[3 3 76]memoot(buffbr,'^.0',a04 8 )l 

focQnf(fp."%Q",buffor) — 1) { 

a. if(otgcmp (buffer, "inot") — 0) { 

b. momoct(bufiFor/\0', 30 4 8 ); 
Q.fooanf(fp,"%o",bufror)i 

d. computor~Tnalloo(otrlcn(b\i£6Dr> *4); 

e. otrcpy(computor,buffor); 

f. momoot(bufEBr,'^iO',301 8 )l 
gTfee £inf(fp,"%o",bu£f'or); 

h. (X ) rvioo~malloo(otrlon(buffor) 4- l)i 

i. otropy(oors i aoc,bufFor)f 



QQDuming wc found q Gomputor and a ocrviQc, then 
3 ohall ocnd it a moooago. 

L338 ijifC oomputcr & & ocrvioo ) { 

a. intfdol[a]: 

b. int fdoa[a]; 



d.ohar *bpT 
G.pipo( fe fdol ); 

f. pipo( fe fdoa ); 

g. oprintfCbuffor/'QUERY ') 6 o^lnQUIT^ln", criteria): 

h. if( writo(fdol[l],buffBr,otrlon(buffbr)) !- otrlenObuflFor)) ( 

i. ^rintf(otdorr, "write to pipo failed ormo- Hd^'oi", ot ' rno)? 
j.rotum( ' l); 

I.Glooc(fdol[l]); 

m.elient_gl(oomputcr, oorviec, fdol[0], fdoB[ll); 

n.oot_nonblooldng(fdoa[0]); 

o.momoct(anowor,"^iO',anowcr_oieo)l 

p.n-roadlinc(fdoa[0],anower,a0 ' 1 8 ); 

q.ifC n ^ 0 ) if( anowcrln ' l] — '\n' ) anowor[n ^ l]-'^lO': 

r.olooc(fdol[Ol); 

o.Glooo(fdQ3[0]): 

t ■rcturn(otgIon(anowor)) 1 
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tdo_quoiy,o(ohai ' ftcritoria, ohoj ^^onowop, int ^anow efesiae) 

[SSSTlehiu «computo>-NULLt Ooewrieo-NULL: 
[B388]i.liiif *lwiffei'-mTTiTiI 
[2389]m l iMuH8l; 

[3300]mtfauaM; 
[3392]uim.'>i .p : 

[2 383] ; jot_tdo_eonncetaoiL-info( & (X)mputcg, fe oorvioo); 
! oomputor I I ! ocrvioc ) rcturn( ' l)l 
inQlloo(otJlon(critGriQ) -»- aOO); 
[23Q6]iiiciii30t(buffor, '^^0^otricn(c^itomQ) ■^^ 30Q); 
[2397]oprintf(buffor/'QUERY %o^lnQUIT^ln^ critcriQ): 

[3398]pipt( &fd u i); 

ft fdon ); 

writo(fdol[l],bu£Fop,otrlon(bu£Fcr)) !" otrIon(buffor)) 
^rintftotdcrr, "write to pipe failed ormo-^ 6 d\n", orrno); roturn( ' l); ) 
[3402]dieiit_gl(computcr, oemoc. fdfll[Ol. fdoa[l])l 
[2 403] j ot_nonblocliing(fdoa[0]); 
[2 40 4juicmoct(^QnDwcr,'^iO',^Qnowcr_oii5o); 
WQitrGQd(fdo3[0]): 



[2407]^ 

[noot(^Qnower,*^iO',ii * l)j 
[2 409]u-roQdn(fdoa[0],^anDwor,D) ; 

|2410k« 

[341l]duLKi(f Julio]); 
[2413]d ooc (fdi i l[l]); 

[3413]ui o iKi(fdi i a[o]); 

[3414]dooo(fdoa[l]): 

[2416] if(ano wo i^sBM^ — *Qiiowcr_ a8e=a?^ 



[2 4 16] ri' uo( oo mpuim ' )l 
[2417] £it ic( u ci^i t x); 

[2418] £i' cc(biii r ci'); 
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[3419]itmm(o); 



[342l]Program Lioting 13.3 TDS oupporting funotiono - tdo^rogiotor j.o 

[3423]^ 
[2424]^ 

[2425] t>T)odcf otruct _tdomog ( 
[2426]iul m u i^: 

[2427]mL boiao: 

— '^bu£Fop; 

[2430]ulutiu ldomog_t tdomog; 
[2 43 llotQtio int tdo,otrlcn(char ^m) 

[2433]mL u o: 

[a434]dmi 

■!»^ rotiim(0): 

[3436]tut(iip iui*op; i i cp) ** d: 
[3437] i cluiu( u ): 

[3 439]mt tdojaotoCTO»(ohM *o) 

^44tiM — — moieo-Oi 
[2443]ulmi «9f 

rotium( ' l)l 

[2444]moigo-tdo_otrlcn(o); 
[3446]if(!moltM:) 

tdomoc.boiac < moie e-M 

Q.if( tdomog.buffcp ) firoo(tdomog.buffcp); 
b.tdomog.buffop ~ (char ^)mQlloo(iiioiec * l); 
o.tdomog.boiac muiao 1 1) 

{2449% 

{244^ ! tdomog.bufFcr) rotumC ' l); 
{244^ ioot(tdoinog.bu£fog, 'VO'.tdomog.bw B^ 
[2460lmomepy(tdomog.bu£fop,OimoiBo); 
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[3 4.6 1] Ulumug,moiBO~m eMey 

[2462]iuiiuu(o); 

[2466]tdD^otoinror(ohag ^m^ int *oiBo) 

{2466]^ 

!m I I ! oi i w) rotum('l); 

! tdomoe.bufFof) { *oiao-Ol T^m-'\Q*; gotuimCO); ) 
[2469]if( ^oiao ^ - tdomog. - nwii s o ) ( *oiflO-tdomog.moiB0 4" i: gotugB (4);4 
[2 460]m t jmu p y(in, tdomog.buffcr, tdomog.moii s o); 

[3462]m[*um j ] 
[3463]rotuim(0); 

[2464]» 
{246^ 

:dojogiotor(chQr ^rogiotJatioiit ohoj ^rcoulto, int ^oiao) 

[2467]4 

^computcr-NULL, ^oorvioo-NULL; 
[2469]GhQr buffor[l0063l 

I2472W 

Hit) 1*0 iBO^ 

[2174L 

[2176k gct_tdo_oonnoction_info( & tdo,computop, & tdo_oorviuc) ■ !) { 

a. if( i^oiBC ) *oigc~Ol tdo_octcgpor("tdo connection fiiilod'^in''); 

b. rotum( ' l): 

[2476]» 

[2477k ! tdo_ooinputcr | | ! tdo_ocr>nGO ) { 

Q.if( ^oiao ) ^oiflc-O; tdo.OGtorrorC'Foilcd to looQte the TDS S orvcpW) ; 
b.roturnC ' l); 

[247 8 ]» 

[2479]ir( pipo( &pipoi ) !- 0 ) ( 

Q.if( *oiBO ) *oiao-Ql 

.ootorrorC'pipc oyotom coll foiled. Probably have too many open filoo.^in")! 
a.roturn( ' l)i 

[2481]» 

[2482k pipuw). o)( 

a.if( *oiao ) *oi i 50-Q; 
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b. tdo_ootorpoF(''pipo oyotom oall fiiilcd. Probably havo too many open fiIco.'>in")l 

c. rcturn( ' l)} 

[3 d8 4ji ' oiBC-tdo_otrion(rcgiotration) * 10Q; 

[3486]if(ioiBO ^- 1006 )( 

a.tdo_ootorFOg("Rogiotration roqucot woo too long.VinMairimum oiac io lOO fi .'^in"); 
b r ctm nC'l ) ' 

{348^ 

[2487]mcmoot(bufiFcg,'\0',roifflo » 1); 

[3488]upgmtf(buffo>,"REGISTER ^oVnQUITtn". rogiotPQtion); 

[2489]if( writo(pipol[l],buffcr,roiHo) !- roiisc) { 

a. tdo_octorror("Failod to ocnd the rogiotration roquoot to tho ocjvcr.^iii"); 

b. if( *oieo ) *oiBo-Ol 
o.gotuim( « l)l 

[3 49 l]ulooo(pipol[ll): 

it^l(tdo_oomputor. tdo_oojvioo. pipolCO], pipca[l]); 
[2 493]mcmoct(buffc^/^.0^ 1006); 

[3494]ir( olooo(pipca[l]) !- O ) fprintf(QtdoCT;'fiulod olQOO of pipca[l]-^ ^ dW', pipca[l]); 

i ' OQd(pipo3[0],MOultD,*oi a o): 
[2496]i.looc(pipol[0]): 

[3497]ijlu u c(pipoa[o]): 

[3498]iauiu(o)i 

^499}^ 

^399W tdojogiotcr_p(ohar ^rogiotration) 

[2601]< 

[2603]eUui pcouitoiioo e i; 

oiac-1006: 

[2605]if( (ro^do_rGgiotor(gogiotration, rooulto, feoiao)) !" 0 ) { 

a. tdo_gctcrrog(rooulto, fe oino); 

b. ft)i ! intf(otdop>,"tdojrogiotop_p' ^o'^in", rooulto); 

[2607]i ui .uiu(i o ): 
{2368]} 

[2600]Program Lioting 13.3 TDS oupporting funotiono • gotdtocinfo. -e 

[361l]//iii u liiilu '^momoiy.h-' 
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[3613]tfif Idofinod TD 8 _C0NNECTI0NJ>ATH 

[3614]# dofino TD S _CONNECTION_PATH "/tmp/tdo.oinfo" 

[2616]#e adtf 

[2616]int got_tdo^oonnootion^info(ohQr **ooinputcP, ohog **oorvioo) 
[2618]uhag bu£Fcg[aQ48]; 

|851 ^riLE »fp-fbpon(TD S _CO>n > ?ECTION JATH."!*"); 

■>JULL)rctivum('l)l 

[363l]wrhile( fbcQnf(fp,"^ 6 o">buffor) — 1 ) { 
Q.if(otromp(buffop."inot") — 0) { 

b. mcmoctCbuffGr, '^^0', 30 48) : 

c. focanf(ft),"^ ^ o",buffor); 

d. ^ooiiiputGir-mQlloc(otrIon(buffGr) * l)i 
o.otPCpy(^oomputior,buffog)i 
£moiiioot(buflfcg.'\0',aO i S )', 

g. fbcanf(Q[),"^ ^ o",bugGi'); 

h. *ocrvico-malloo(otrlcn(buffor) * 1)1 

i. otrcpy(^oorvioo,faug iBg^ 

[252 3 J ruiu(xi(rp) I 

[ 2524li ctum(Q>: 



[2626]Program Lioting 13.4 TDS oupporting functionG • tdQ.c 

[2628]//inoludo *^mQlloo.hr* 
[2629]//includo ^oyoAiton aaeA^ 

[2630] 



•ffincludo '^KiCTPO.h^ 
[263 iJliyTpodof otruct Jo.t { 
[2632]char ^fiold.namo; 

[2633L 

[253 4 ]intpublio; 
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— (tdootinictog)(io_t *)? 
— »(<tinahojo)(ohaj ^, ^ chp-^ 
[2642]i €di *(*looQto)(io_t *, ohQg ohQg *); 

[2544] bypcdcf otruct _oto_t { 
[2646lic.l *ieT 

V ^ I Jot 

[2 6 lypcdcf otruct _otcJbaoc_t { 
.{2^g6}etez$ 

[256l]6 te=$ «ktet; 

[2 553] lypcdcf otruct _oto_Lt { 

[2664]i ftt (*Qddio) (otc_t ^. char *, ohor 

^(*oonotructor)Ol 
[2666]4 afe (*dGOtructor)(oto_t 

[2657]oto_t ^(*locatG_by_ncuno_aiidJooQtioii)(ohar^, ohor -^ 
[2558]Qtc_t »(^locQtG,by_io)(chQi' *); 
[2569]Qto_t ^(^locQto,nciit_by_ic)(oto_t ^,ohar 

[266 llcKtcm otoXt oto_fi 
[2562]otQtio char ^ 
[2663]ljOCQto(char ^^critcriQ) 

[2566]QtQtio char gbufft400 6 ]; 
[2666]GhQr ^Qpowcr-gbug ^ 

*namo~NUIJj, *looQtion-NUL J»^ 
[2668]un j _o ^otc; 

[3569]iit u ituia && otjlonfaritcrio) 1) 

Q.if( *(oritcriQ 4 otrlon(critoria) ' l) "^^u') 
b.*(oritoria 4- otrlon(oritorio) ' 1) ~ '\0"i 

[2670]ldo^ct_nlpp(crito^iQ, & nQmc,&loGQtion,^^JLL,^^ULL,^aJLL,^^ 

ifdmmo — NULL I I location ^^JLL) oto ~ oto_f.looatQ_by_ic(critogia) ; 

oto - oto_f.looatc_by_namo_and_looation(aamo,looation); 

onowoygbuffi 
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yhilo(oto) { 



b. whilo( io ) { 
o.if( io'>publio ) { 

d.oprmtf(Qnowcj,'*%o~'^t"^o'>/' io * ?^fiolcLncunoi io ' i*fiold_valuo): 

c. Qnowor-gbuff * otrlcn(gbufiD; 



i.oto - oto_f.looatc,no3rt_by-io(oto,critoria); 
j.oprintf(Qnowog,"'^ji"); 
ter anowcr-gbuflF i otrion(gbufiDi 

[2 5 TGli ' otmmCgbu i^ 

fo K7o 1 

[358l]njliujn(NULL); 



[2684]nc b iuLLi 
{238^^ 

_t ^oto - Qto_f.oonDtruotorO; 

[3687]e 
{2688}« 

*vq1uO» 
[269l]QtQtio int rogid ; 

Q.whilo( *op && ioopQoo(*op)) 1 1 opl 

b.vQluo-namc~Qp; 

0. whilo( NqIuo && ^^vqIuo !~ '-') > > voluoi 
d.if( lvalue — 

fcint uoo_quoto-Ol 
e■»vQl^o^"'^^0'; 
h. I I' valuo; 

1. cp~vmluG) 

j.if( ^vq1uo--= -'^ 

k.( uoo_quoto~li * > opi i i voluoi ) 

Lwhilo( ^cp ) { 

i:if( uQO_quotc && (^op — "")) bfooJi; 

ii.oloo if( uoc_quoto — 0 && ioopQoo(*cp)) brooli; 
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«4 

n.if(*op) ( ^op-">iO'; oto_f.Qddio(oto,niuno,valuo)i < t cpl } 
o.Gbo oto,f.Qddio(oto,namo,¥Qluo); 
pM ufxi^quoto) »* op; 

[369d]oprintf(ontiiy,"^d'\rogid)l 

[3595]Miti^id; 

[2696]mtm ' u(omii'y); 

[3698]lypodof otruct _tdo^ ( 

(*quor>T)(ohQP *); 

^ (*dclcto)(chM ^ 

* (^addontity)(cliai '-*>; 
[3603]) ul u JLi: 

tdo_f--{ 

Fafio ill iii.il li 

[3606]do1uuj. 
fOfiOfiln LI 

[3608]//uiui u Q TO difEBPonli wayo to uoo thio fun etoar 
— WO can otQtioally link it into an app, 
WO can dynomioolly load it at pun time 
I can invoke it firom a gcnorio firont ond loader 
— it can be invoked by oclocting on an icon having oooociatod the gcncmo firont ond loader 
[2613]int tdo(int argo, ohor ^ii^argv) 

[2615] otatio ohor ^gbuffi 
[2616]otatioint gbufLoiao; 

[3618]iana_ o uL i: 

[26 1 93i»t-af 



{262 l]if(argv — >JULL) ( fd_in-argo; fd_out-apgo; ) 

fe68a^bugLoioc-3Q<8: 

[2623]bI j uI I malloo(a01 8 )l 

Oin^oitj t ottdttajni 1000); 
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b. if(n — 0) oontinuol 
G.n - pook(fd,in); 
d.if( n 0 ) bJOQk; 

c. if(n>0)( 

f.if( n ^ (gbuff_oino - H) ) 

iftgbuff) froofebug); gbufiF-molloofa t 1); gbufLoiao-ii ' H; > 
Q.momootfebu£f,'\0'.gbufF_oiBo); 
b. n-roQdlmo<fd_m,gbuf^gbuff_oi Be)^ 
o.if(n — 0) break; 

d. Qrg~oommQnd~gbuff; 

0. whilo( *QJg ft& *arg |- '\n' && I ioopQOo(^Qpg)) * 4 org; 

f. if( arg & & ioopQGc(^QPg) ) { ^arg ~ '\0", *4. Qrg; } 

g. if(otrcmp(oommand,"rcgiotcr")^ =0)4 

fe ehag *1ioid ~ tdo^.addontity(arg); 

U.if(ticid) ( writo(fd_out,tcid.ota?lon(toid)): writo(fl_out.'^inM); ) 

1. cIoo if(otgomp(oommQnd,"quoiy")~-= ^ 

i-chop ^ontryi 

ii. cntr}^-tdo_£quog}^(afg); 

iii. if( cntr}^ ) 

ritc(fd_out,ontry.otricn(cntry)); writo(fd_out,"\n", 1); ) 

b.cloc if(QtrGmp(GommQDd,"dGlotc") — 0) tdi3_f.doIoto(agg); 
cckx) if(otrGinp(oommQnd,"QUIT") — 0) break; 

[3637]} 
[3638] it iui i i(o). 



[2630]Program Listing 14.0 prooooo funotion • cpo-o 

[263l]//iu e luJn ' «i tdio.h>#inoludo ''fimtl. -h^ 

m int tid_.oigo; 

{263^ 



[2634]pi KM icooGnt fd, void *argo, void *handlo) 

[3636]ulim ' *buCFor, *ocupgo[3ll 

[3638]buniii -(char ^)nialloo(tid_oiBO -*- 6); 

(p ~ pock(fd)) !- tid_oiBo) poturnC - l); 
[3640]m u moct(bufifog,'\0'.tid^oiBo > 6); 
[264 l]oprintf(bufFor,"tid-"); 
[3643]i u ud(fd. ,buffom ' 4,p); 
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rotiurn( ' l); 

[364d]Ll uu o(fJ)i 

on directory 

[2646]oargfl[l] -bufifcr; 

[3647] u m b u[al '\o'; 

[2648]fd-opon("paymcnt_info"^OJtDONLY): 
[265l]iauiu(0); 



[2663]ProgrQm Lioting 14.1 procooo funotion - opo2,o 

[2654]j/in u ludu ' u bdioAi-^noludo ^fcntl.hf>C3rtom int tid_oi i so;oKtom int oid^oiaolint pgooooo(int fd, void *Qpgo. void *handlo)( eha 

*tidbiigGr; choj oidbu£Fop[aQ1 8 ]; ohog »OQrgo[ 8 ]; oho? onowcrClOO S l; ohoj *op--NULLr 

[2666] Lidbu£foir-(chag »)mQlloo(tid_oiiSO -*- 6); 

[2656]if( pookCfd) !- (tid.oii i c * oid_oiBe)) rotumM); 

[2667]mcmoot(tidb^£fop,^0^tid_oiBO < 5); 

[2668]ia r .omoot(oidbufiEDg/>iO',a01 8 ); 

[2669]oprintf(tidbuffog,"tid-"); 

[2660]oprintf(oidbu£fcg,''quojy oid-^); 

[2661L H;Qd(fd,tidbuffiiF »' 4,tid_oiBo); 

[2662]i ' OQd(fd,oidbiifiFop * 10,oid_oiao); 

[2663]if(p€ck(fj)) 

[2664]d u oc(fd); 

[2665]tdo_quor>r^(oidbuffcp, onowor, 400 6 ); 
[2666]tdo_got_nvpQir(Qnowor, " S omoo Pjo%adcr", & op)> 
[2667k ! u p Xiaui i K 1);) 

[2668]fprintf(otdout,"Connoctioii for Paymont Infonnation fiwm ttoW.op); 

[2 669] fprintftotdout, "Aoocpt? ''in"): 

[2670]lbGQnf(otdin 

Qti'Gmp(QiiowGr,"yoo") !~ 0) rcturn( ' l); 
irgo[Q] - "nomc-Voommon dii>ootor>^ ocrviGoX""; 

[3673]^ 
[367 4]b 

[26 7 5]fd-opon("pQyinoiit_iiifo".O.JtDONLY); 
[2676]jupa(fJ,0); 
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[2677] b foi(Q. u m bu ); 

[3678] ji yt(UJbufrci): 
[3679] i amu(0): 



[26 8 1]Program Lioting 14.3 procooo fiinotion - opo3.c 

*^otdio.hr^#ineludo ^figntLh^oxtoim int tid_oiao;oictoni int oidLoi B Ciint ppooooo(int fd, void '^argo, void *hQndlo)( efea? 

nidbuffor. oidbuffiprlaOl g ], *OQPgot 8 l. QiiDwog[l006), i^qc-NULL; 

[2683]ohQr ^vioa-NULL, ^mc-NULL. myoawitypoteia], myoardnuinboj[5ia]; 

myoordoiipircotelS], char bufiBBp t3&48i; 

[3686]iu6 fjulal; 

[2686]tidbui i ii (dmi- ^)mQlloo(tid^oiao * 5)l 

pccli(fd) !- (tid_oii i o * oid_oigc)) Potium( ' 1)1 
icmoct(tidbu£fog.'^iO'. tid_oiBO * 6) ; 
[2689]momoct(oidbuffbr,'\Q*.a018); 
[2690]uprintf(tidbufifcr/'tid-")l 
[269l]oprintf(Qidbuffor,"quogy oid"^); 
[36931 ?cad(fd,tidbuffcp * ititLoinc); 
[269 3] i ead(fd,oidbvi£Fcg * 10,oil_oifflo)l 

[2694]iKp^ i ik(fj)) 

fSfiOfiliT aiLffJV 

[2696]ldo_quco^JP^oidbuficr, onowor, 100 6 )) 
[2697]ldD_eot_nvpQip(anowor, "Amorioon Eirppcoo", & qo); 

:do_got jvpair(anDwor, "Vioa", fe vioo); 
[3609]ia u _i . Lt. .nvpoirConowor, "MaotxirCord", & mo)l 
[3700] L m bu [0] "nam o-'^>"c!ommon directory ocrvi(»V'"; 
[370l]^ bo [i] tiJlufl -.. ; 

[3703] . u. bu [3] ",o': 
{3703k= 

opon("pQyincnt_info", 0_RDONLY) ; 
[2 7^)4^pipo (fdo) » 

[2705] whilG(rcadUno(fd.buffor.804 8 )) { 

a. if(ao) { qo-NULL: tdo_gotnvpaig(bufFog,"Amorioan E3iptooo'\ & ao); 

b. if(ao) { wgito(fdo[ll,bufifor,otglcn(buffcr)); broakl } 
e4 

dM vioa ) { vioo^NULL: tdo_gotnvpaij(buffcp,"VioQ", & vioa)? 
o.if(vioa) { wgitc(fdo[l],bu£Fcg,otrionftmgbp)); broak: } 
U 

g.if( mo ) { mo"-NTJLL: tdo^otnvpair(biiffor,"MaotorCapd", & mo); 
tLifdno) ( wgito(fdo[l]^buffbp,otglcn(buflFog)); bgoak; ) 
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i4 

[3707]if( pook(fao[0])) ( dup3(fdo[0],0)l efcl(3.oagco)l ) 

[3708]r i to(tidbu£Fop); 
[3709]d uu t(fa u [o]); 

{3713}} 

[3713]Program Lioting 14.3 procooo funotion ' opod.c 

[8714]tfmdudL 

[2715]tfinoludo <foiitl.h-^ 

[3716U pioccoodnt fd, void *orgo, void ^handle) 

[3717L 

bugbr[30« 8 l; 

[a719]aiui n; 

4deref 

[373 l]fd o opcn((t-mlitcmp("/homo/go/K)XXXXXX")).0_WRONLY); 
[3733]. >bilo((o"»ottd(ffltbuffof 130 ( 1 8 )) > 0) write(fdotbuffo»)o)i 
[2723] »iitott t lit>ot»lon(t)); WHto«a,''>.n%D; olooo(fiO; 

[2726]Program Lioting 14.4 procooo fiinction - (ipoS.o 

[2727]»muluJu 

[3738]//inoludc *^fcnti.h-* 

) proooooftnt fd, void *ajgo, void ^handle) 

« fiacunc[30 i l 8 ]; 

[8732]uhai ' bufforf ae4^ 
[3734]iutfdi. o ; 

[3735]momoot(fanin ( ?,'V iO '.fl 0 1«)l 
[3736]iOQdlino(fd,fiiamo,80 ( 1 8 )l 

[3737]if( (fdi-opcn(faQmo>0_RDO>njY)) !" ' !) whilc((o-gOQd(fdi,bugbi ' ^a048)) > 0 ) 
[3738]vyi ' ilo(fd.bu£For,o): 
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[3740]d uu L(fJ); 
[374l]iumm(o); 



[3743]Program Lioting 15.0 otatoful ocrvico ■ main.o 

[3744]//imludo I ' iU tdio.hMiit mQin( int orec ohog ^ag gvB)< iftoggo^ i){ ^rintf(otdorr,"oorvioo <prot ( 

a.exit(l); 

[2746]tGp_Q000pt( 3 , orgv, Qrgv[ 3 ]); 



[3740]Program LiBting 15.1 otatoful aorvioo - tcp_accQpt.o 

[2750]//inoludo ^otdio.h . >#inoludo *^miifltd.h^#inoludo <otdlib.h^#moludo <oyo/oockct.h>#includc *^yo/tiypoQ.h^#includo ^oyo/timo.hs* 

[2761] 



[2752]//iuelud8 

[3763]//mauaL 'uaab.b- 

[3754]//includc ^dlfcn.h> 

[2 7 5 6] int top_QOOCpt(int orgo, ohoj *^Qjgv, char i^oorvio e) 

[376614 

[2 7 5 75-184 liotcnfd; 

[3768]iiiO — connfd? 
[2769]ooclilcn_t Qddrlen-0, Ion; 
[2 76 0] otmctQ oc ka ddr * cl iQddr: 
[376l]iimc_t tieke; 

-[3763W. 

[3763]. leid '^lib handl ed 

[2764]i ftfe (^^fimotion)(int,char ^Y, 

(2 7 6 5 Jiii^- (libhandlo - dlopcn("./libocrvioco.oo.l.O",RTLD_LAZY)) — ^WhU 

a. ^rintf(otdo^ !l ^"dlopon liboorviooo.oo fliilod avvm %d\n" orrno); 

(function ~ dloymOibhandlo, ooi ' vi u o)) NULL) { 

Q.fprintf(otdcFr."dlo>TD of function [%o] failed ca'no"06d>in", oorvioo, omno); 

b. ^rintf(otdorr, "ocrvico not availablo'^in")) 
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Mgo i-^ a ) liotonfd fcipJioton(MtJIJji oigv[l]| ft oddjlon); 
[3769]ti« u liotonfd " t epjiotondugvllli MgvM) ft oddrlon); 
[27703»JiuJJi I mQUoo(addrloii)! 
[277l] i b . (:iO{ 

a. lon - addplon; 

b. oonnfd ~ accoptdiotcnfd, cliaddr, & lon )l 
cprintfCoonnoction from: ^o^m", oocli,ntop(cliQddj,lon))j' 
d.if( function ) { (*funotioIl)(oonnfd,^^JLL); olooc(oonnfd); } 
o.oloo { ticko-tiino(>JULL); oprintf03uff."%.aio^in",ctiinc( & tiol£o)); 
f.writo(oonnfd.bufF,otplon(bii£D); 

[3773]» 

[2774]Program Lioting 16.2 otatoful Gorvico ' tGp_lioton.c 

[3776]//iiitiudL '' ■ otdio.h - "'*inoludo '^uniotd.hftfineludc ''otdlib.h' ' #ineludo rtoyo/typco.h'^noludc ■ ' ■ oyoftuno.b'' 

[2776]#iuaudt 
t2777]#iiiuiuJi 
[3778]ffii«jujo 

[3780]//if ! dofincdaJ S TE>?Q) 
[378l]//dufino LI S TENQ 366 

[27881/1 Liilif 

tcp_liotcn(ohQr ^hoot, char *ocpv, oocMon_t ^addrlcnp) 

[3784]4 

liotonfd. nJ 

[37 8 6] u> uuliul u n l; 

[2787]otruct addjinfo hintOi *roo, *goooavo: 

— »handlo-NULL; 

[278Q]bgoro( & hinto> oinoofCotguct addrinfo)); 

[2790]hiuto.Qi_flQgo - AI.PAS S IVE; 

[279l]hinto.ai^ay- AF.UN S PECl 

[2792]hinto.Qi.ooclrtypo-SOCK_ S TREAMl 

•gotQddrinfo_gQmi]c(hoot, ocrv, &hinto, &rco)) !- 0 ) { 
Q.^rintf(otdorJ,"tcpJioton' gotaddrinfo failod orrno-%d^in", orrno); 
b.omt(l); ) 



[2796]d u { li o loufd " oookotd'oo ' ^ni^fnTnilyi gco ' "*QLooolrtiypo, poo ■ ^aLprotoooDI 
[3796]if(liotonfd<0)( 
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[3797]i j otoooliopt(liotoiifd. S OL^ S OCKET, S O.BEUSEADDR, fe on, oiBcof(oD)); 

bindftiotciifd, rco - ^aijddp, i » oo - >Qi_QddrIcn) — 0 ) bgcak; . 
[8799]daocaiotonfd); — ) wh^o((gco-^!CO ^ ^fti_nolrti) NULL )] 
[3800]if(f > co — }flULL ) ( ft>rintif(otdoCT,"topJioton: arvov for ttOr^oW, hoot,oogv); 

■[38Q3 }uo1icnmotonfd.LI S TENQ)i 

iddrlcnp) ^Qddjlonp-goo ' >ai_addglonI 

[2 80 4] ii ' ccQddginfo(gcooavo)l 

[2806]i ' 0tupn(hotciifd)? 
fOQ Qfil 



[2807]Program Lioting 16.3 Gtatofiil oorvioo - gotaddrinfo. e 

portiono of tho oodo ojo derived from W. Bioh n rd S tovcno implomcntation of gotaddria fe 

i S cc Un i jr M o tir orl r Pr n cr nm m inc fn r rl rt in i ln nnrt y n ri n tinn n 

[2810]ffinoludo "oogviooo.h"#includo ^ . rGoolv.h^^tfiiioIudo '"ctypc.h^ ^ #inoludc *v > tring.h^int gotaddripfo_gamix(oonQt ohor ^hootnomo, ooftefe 
nhnr ^nnrv nnm r. mwnf ^tf^^t n i fl rinf n *h in t in p. ntmnt ndfirinfr **TTffl Ml^ 

[3811L 

[2813]iuUutu u i.iiu.ai.U; 

— **Qp, ^oQnon->JULL; 

[28 1 djotruot hootont ^hptr; 

[2815]otruGt ocaroh ocorohl a ], ^optri 
[2816]otruct Qddrinfo hinto, ^aihcad. ^^^oipncHt; 
[2817]//aLfiiit crpor(o) { error ~ (o); goto badi ) 

Lid U X \Jj UinCQQ IN U iJiJJ 

[2818] aip nGiit-&Qihoad j 
[2820] t jmion-NULL; 

[282l]if(hintop — MULL) ( bBCPo( fehinto, oiBoofOunto)); hinto.Qi.fimiily - AF,UN S PEC; ) 
hinto - ^hintop; 

( ro~EO, oo h tc h( ho nt inni nr, nr rvn nmn , hintn ni_flncn hintn ni fnmily, hintn ni ofTT^lrV i TTfT, hint^ p»»^nn«i)^ t- nl n^niir«nV 
[383d]if(hootnamo !- >fULL ft ft 

b.otrcmpOiootnamo/VuniK") — 0) && 
cXoervnome NULL && oorvnomolO] — ?)) { 
d.rctium(gQ_umK(oogvnamc, &hinto, rooult))! 

£S82^ 

[282^nooQgch ~ gQ^nocQJchChootnamc, & hinto, & ooarch[0])l 
[2827ifog(optr - &ooagch[0]; optr & ocajch[nooaroh]; optp i i ) { 
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Q.if(iodigit(optr '. ''^hoQt[0])) ( 
b.otruct in^Qddr inaddri 

o.if( motJ^ton(AF_INET,opt^ ■ ^^hoot, ft inaddr) — 1) { 
i.if(hinto.ai_fQmily !- i\F_U>? S PEC & & 
u.hmto.ai_fiunily !- i\F_I>JET) error (Ei\I_ADDRFAMILY); 
uiM optg'i^fiiinily !~ AF_JNET) oontinuol 

iv. ro-ga_Qiotruct( fe aipnoict, fe hinto, ft inaddr, AF_INET)? 

v. if(rc !- 0 ) QWOvM i 

vi. oontinuo; 

e4 

fiif((ioKdigit(optr '- ">hoot[0]) I { optr ' ^hoot[0] — ' 0 & & 

g. (oteohj(optJ ' >hoot; 0 !- NULL )) { 

h. otruct in e ^addr in e addrl 

i. i^(iIlctJpton(AF_INET 6 , optr'^hoot, A inGaddr) — 1) { 

i ifthi nt o o Lf nin ilr '- AF_T7MfiPT ; rr ft r ffr 
u.hiiito.ai.^ily !- x\FJNET 6 ) crror(EAUU)DRFAMILY)l 
iuM optr-^fdmily !- AFJNET 6 ) cwntinuo; 

iv. ro-gQ_QiDtruot( feaipncxt, fe hinto, &in 6 addr, I'VF.DrET S ); 

v. ifdw I- 0 ) OCTorCro); 
vi^oontinuci 

Lif(Lrco.optiono & RESJMT) — 0 ) roo.initO: 
m.if(noGQrch — 3 ) Lrco.optiono & - ■ RES_USE_I>JET 6 ; 

[hptr - gothootbynamca(optr« i ^hoot, optr'"*f n mi ] y)T 
b cloc { 

0. 1ftoptT 'i -'fiunilit --AFJ>?ET6)_rGo.optioiii) | - RE S _USE JNETSI 
d.cloo_roo.optioiio ■ RES,USE_n>JET 6 : 

chptr ~ gothootbyiiamo(optir'^hoot)l 

g. if( hptr — >JXJLL ) { ifCnoooroh 2 ) u u ii l inucl 

h. owitoh(h,CCTno) { 

1. caoc H0ST_N0T_F0UND: Grpor(ExM_NONAME): 
j.caoe TRYj\Gx\IN- crror(EAIjVGAI>0; 

k.oaoo NOJtECOVnSRY' crror(EAI.FAlDl 

I.oaoo NO_PATA- crror(Ei\I_>JODx\TA)l 
m.dcfQult: crror(EAI,NONAME)l 
«4 

p.if(hiiitQ.Qi_fQmiIy !" i\F_UNSPEC & & hinto.oLfiunily !- hptg ■ ^h^addrtypo) 
qxrror(Ei\I_x\DDRFMQLY)l 
r.ifChootnamo !~ NULL && hootnomoLO] t- '^lO' ft & 
oXhinto.aLflQgo & AI_CAN0NNM1E) && canon— NULD 4 
t.if((canon-otrdup(hptg'?*hjiamo)) — >JULL) 
i.owop(EiM3CEMORY); 

v.for(Qp-hptP ' >h^addr_liot; ^ap !- ^aJLL; op -t - t- ) { 
w.ro~gQ_aiotruot( & aipnc]rt, & hinto, ^ap, hptr ' ?^h_addrt>i)c); 
M.if(po !- 0 ) orrorCre); 
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{2828}} 

[2830]if( aihOQd — >nJLL ) Grrop(EAI_NONAME)l 

[283l]if(hootnQmo !- >aJLL && hootnamc[Ol !- '\0' & ft hinto.aLflago & x'\I,CA>?0>n>JAME) { 
aM canon !- >rULL ) aihoQdT^oi.QQnonnaino - oanon; 

Q.if( (aihoQd ' ^QLoQnonnamo ~ Qtr(iup(ooaroh[0],hoot)) NULL) 
i.crror(Ei\I3IEMQRY); 

[2833]if(oci^Tiamo !- >rULL && oor^rnamoiOl !- '^.0') 

Q.if((ro-gQ_ocrv(QihcQd, fe hinto, oorvnamc)) !- 0 ) OPforCro); 

[2834]^ 

[3835]icituu(o); 

[3837]^ 

L'lW JT^vCCT^T^VTXTTTT' 

rOQQQl 

[3840]Program Lioting 16.1 ■ Filo SER\^CES1 Sorvico protot>T)0 tablo. 

[284 l]%inoe)fldo)Doocription I Connoctivity I S pid 

[28 42]rQymcnt S orvioc I lOa. 1 68 .317:0000 1 1031 6 6 8 101031000 

[2 8 4 3] GuiiLuub Information S crvioo 1 103.1 68 .317:000 8 1 1031663101031003 

[2844]DijcotiOiy S oiT%dec | 103.1 68 .347:00071 1031 6 6 8 401034001 

[2846]uRLRotrioval S crvioc 1 103.1 68 .317:0006 1 1031 6 5 3 101031076 



[2846]PrQgrQm Lioting 16.3 - File SER\^CES2 Scrvioo protot>T)o table. 

[2847]%moe)fldo)Dcoogiption I IntomotAddJCOO I Port I S pid 
[2848]pQymontScg%doo | 103.1 68 .317 1 00001 1031 6 68101031000 
[2849]contQot Information S orvioo 1 103.168.317 1 000 8 1 1031 6 53101031003 
[2850]DiJOGtory S or^ncc 1 103.168.317 10007 1 1031 6 5 3 401034001 
[286 l]uRL Botrioval S or%'ioo I olmor.gtlino.oom 1 0006 1 1031 6 6 3 101031076 

[2862]Program Lioting 16,3 - Filo SER\^CES3 Sorvioo protot>T)o tablo. 

[2863]%mm{)fldo)Doocription I IntomotAddrcoo { Port I Protoool { S pid 
[2864]paymont S or%doo 1 103.1 68 .317 1 0000 1 HTTP 1 1031668101031000 
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[2866]cuntQOt Information S crvioo 1 102.16 8 .317 1 000 8 1 S OAP 1 1031 6 6 8 101034003 
[SSSGlpii - ootoo' S orvioo 1 103.1 68 .317 1 0007 1 S OAP 1 1033668101031001 
[2867]uitL Rotriovol Sorvioo I olmcg.gtUno.com 1 0006 1 HTTP 1 103166 8 101031076 

[2868]Prograin Lioting 16.4 - Command lino to gonorato data dictionary from 
prototype tablo 

[2869]$ DC ' PGd S ER\aCE S > rod.SER\aCES 

[2860]Program Lioting 16,5 ■ Gonoratcd Data Dictionary 

[386l]//{RECORD,CLx\S S (SER\^CES) 
Qr ■ ^Jb^_Pop_PQrGnt. ^Q - ^^> 

[3862]//{DIN,BUNCH 

a. #{ FILE ( S ERVICES) 

i. «^DQta_JntorfaQO, DC> 

ii. '^Unit.Scp, ^ I ^> 

iii. '^Commcnt.Bog, 

iv. *iBlooIi,Bog, 

v. ^Block.End. ^)^^ 

vi. 'S_^MaH_Rco_Lcn, 6 0^ 

vii. 'i_jabg_OLRooo. 1-^ )# 

[3864]ff( BUFFER_BUN eS 

Q.#{ BUFFER ( 1 ) 

b. #{ KEY.BUMCH 

c. /*^ thio io juot Q guooo at a koy 

i. #(KEY(l) 

l.^Ficld. Dcooription?^ 

ii. #{I>rDEX_BU>?CH 

l.#< INDEX (1) 
3.'-:Kind, btJoO }it 

\i\yf f 
o.#{FORMi\T 

FIELD (Doocription) 
l.'^Datatypo, S TR"* 
S.'^ .S iiso, 

S.'-^^Pooition, l-^ )# 
FIELD (Connectivity) 
l.^DatQtypo, S TR^> 
3.<" .S igo, ^T^^^ 
8.*':_Pooition, 3^ )# 

iii. #{ FIELD (Spid) 

l.^Datat>i)o, S TR^ 



Page 224 of 229 



Marked-Up Version of Subsitute Specification 
Application 10/068,077 



{386^ 



[3867]Program Lioting 16.6 ■ Sorvicoo3 prototype table 

[2868]%moe)fldo)Doooription I InotAddr I Port I S poid I Namo I Looation I Id 
[3869]paymont S cr%'ioo I lOa. 1 68 .317 1 0000 1 10 8 1 6 63101034000 1 I 1 10 8 1 6 68401034000 
[2870]contact S orvioo 1 103.1 68 .347 1 000 8 1 1730860 38 1034007 1 I 1 10 8 1 6 6 8 401031001 
[387l]Dijoctory S ervice 1 103.1 68 .317 1 0007 1 17308608 3 1031007 1 I I 

oalco roport ocrvioo I olmop.gtlino.oom j 0007 1 1730 8 603 8 1031007 1 or.qiy 1 I 
[3873]uoop S cPvioo I tommy.gtlino.oom 1 0007 1 1730 8 603 3 1031007 1 uoorCh 



[2874]PrQgram Lioting 16.7 - Generated Data Diotionary for Serviooo2 

[2876]//{RECORP_CLASS (SEB\^CES3) 
12876] ^>?br Jorjoront, ^O ' T*^"^ 

[2877] = _LQot_VQUdQtod_ForJtod_UTC, ^1073 ' 0 8' 16®01-3 6 Se'^^ 

[2878]//[DirLDmJcii 
[2879]//{nLE ( S ER\acE s a) 

Oj'sDatQjntcrfaoo. DC> 

b. '-?Unit_Sop, ^ 1 
or ' Commont_Bog, 
d.^ ' Blocli_Bcg, ^(^^ 

c. '^Blooh,End> ^)^^ 

f. '^_>lQ3t_Rcc_Lon, 0 3 ^ 

g. '^_Nbr_Of_Rooo, 6"^ 

h. ^_J 5 ii5C, 110-* )# 

|S88^ 

[38 8 DUFFER JUMCH 

[3882]//( DUFFER (1) 

[2883]//( ICEYJUNCH 

Q.#{KEY (1) 
b.'^ ' Ficld, Doocription'^ 
o.#(I>?DE3LBU>?CH 

d. #{ INDEX (1) 

i. ^Knd, btroo> 

ii. '^_Btroo_Hoight, 0"* 

iii. ^_>Jbr,Of_Koyo. S*^ 

iv. ^ _JVTg_JteQoh. l.OOO'^ 



Page 225 of 229 



Marked-Up Version of Subsitute Specification 
Application 10/068,077 



v. ^_>a)r_Of_Koyo_l, 5> 

vi. ^_Avg^RcQGh_l, l.OOO?* )# 

m 

[3886]//{FORAL\T 

a. #{ FIELD ( Doocription ) 

b. '^Datatypo, STR"^ 
cr - SifflC, ^"f^r^ 
d.^_Jooition, 1?* lit 

0. #{ FIELD (Inotaddg) 
f '^Datatype, STR-^ 

h.^_Pooition, 3"* )if 

FIELD (Port) 
jj^DQtat>Tpo, INT^ 
li.^ ' Sieo, _long_> 

1. ^__Pooition, 3 > hf 
m.#{ FIELD ( S poid) 
n.^DQtQt>T)o, S TRr> 
or iS l g c. 

p.'^ Pooition, 4?* }# 

q.#{ FIELD (Nomo) 
rr . DQtat>T)0. STR^ 
o-^Nbr_PopjQJont> ao . MA:> 
tr -S iisc, 

u,r'._Pooitioa, 6"* }# 
v>#( FIELD (LooQtion) 
w.'^Datat^Tjo, S TR" » 
K.^>Jbr_Pc J_Parcnt. ^ 0 ' ?^ 1 
y.'^mc, ^^^"^ 

g.^ ^Pooition, 6 ?* \if 

QQ.#{ FIELD (Id) 
bb. ^Datatype, S TR-^ 
oc^NbrJop.PQrcnt, ^0 ' ^1^> 
dd.^Siao> ^^^^ 
cc.^_Pooition, 7^ ]1t 

[2887]) # 

rOQQOl i 

[2800]Program Lioting 16.8 " Providoro prototype table 

[289 l]%moB)fldo)NQmo I Email I Id 

[2892]chQrlco Northwip i qii@gtlinc.oom 1 10 8 166 8 401031000 
[2893]ri ' Qiik Angol IfranlmOgtlincoom 1 103166 8 401034001 
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[3 8 94]ProgrQm Lioting 16.9 - Pro\Tidoro gonoratod data diotionory 

{ RECORD_CLi\SS (PRQMDERfi) 
[3896] :JJbr_Pcr_PQrcnt. ^Q . ^^r^ 

^ . ^Loot^ValidQtod Jor_Rcd,UTC. 1078 - 03 ' 15@0 l a g ' 
[3898]//(DIN_DUNCII 

[2899]// (FILE (PRO\TOERS) 

a. ^DataJntorfinoo, DC^ 

b. '^Unit.Scp, ^ I 
c^ - Connncnt.Bog, 
d.^BlodiJcg, ^(^-^ 
G.^BIocIi,End, ^)^^ 

f. ^__Miui_Roo_Ijon, 40^ 

g. ^_Nbg_01Jteco, 2" * 

[2903]//{ DUFFER (I) 
[3903]//( KEY_BU>TCH 

a. #{ia;Y (1) 

brFiold, Mnmo"* 
o.#(Pn)EX_gU>JCH 
d.#{I>n)EX (1) 

i.^ . Kind, btroo?^ 

u.rt_BtgooJfcight, 0^ 

ui.^_>n3r_OLKoyo, a^ 

iv. r;_Avg_RcQch, 1.000^ 

v. '^_>air_Of_Koyo_l, 2> 

vi. '^_JVvg_RcQQh^l, l.OOCr* )lf 

roQfi>ii .. 

(FORMAT 

Q.#{ FIELD (Namo) 

b. ^DQtQtjT)o, S TR^ 

d.^_Pooition, 1=^ ># 
o.#{ FIELD (Email) 
f.^ . DQtQtjTpo, S TR^ 



hr . _Pooition, 3^ )# 

FIELD (Id) 
j.^Datatypo, S TR-^ 
li.^ S iao, ^^^^ 
l.^_Pooition) 9 > )# 
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[3910]Program Liotdng 16.10 • Cymbal inotruotiono to inoort record 

Inocrt,In_ScrviocoSO I 



PROCEDURE tJonoQOtion took ' 

{281^ 

Chango oo.that ( 

JoQ S ER\r[CESa whoro ( Dcocription - "Rooording S crviooo" 

a. and Inotaddr ~ "porky .gtlinccMjm" 

b. and Port - 0000 

o.Qnd fi poid - "17358608 3 1031007" 
d-ond Id - "10 3 1 6 58101031000" 

Too ml 



[aoaOlProgram Lioting 16.11 - Cymbal inotruotiono to roport rogiGtration entry 
information 

[292l]d o Dkipluy with^format .tablo^ oaoh [.doooription, .namo, .id] 
ichL.timo( 

[3923]tUuJO_io^Q SER>aCE S 3 whoro ( 

Q.Dcocription - .doooription 
b.and Id ~ .id ) 

[2924]Qnd thcrcJo_Q PROVIDERS whoro ( 
Q.Id" .id 

b.and Nomo ~ .ncuno 

{282^ 
{282^ 

[2927]Program Lioting 16.13 ■ Global Dofinitiono 

[3828]Bl u loLdeliiT 

PROCEDURE twuinoiition taoh ' 
vieco3( S TR .doocription, 
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Q. S TR .inotaddr. 
b.I>JT .port, 
O. S TR .opoid, 
d.STR .id) 

[3031]4 

[2932]d o Chango oo^that ( 

_ioQ S ER\r[CES3 whoro ( Dcocription ~ .doooription 
Q.Qnd Inotaddr ~ .inotaddr 
b.ond Port " .port 
cond S poid ~ .opoid 
d.ond Id - .id 

[2936] Program liotingo © copyright 3003, Global Toohnologioo Limited Inc. 
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